Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Data (V1Alpha) - Report Task → Get Report Task

AI-generated

Overview

This node interacts with the Google Analytics API, specifically supporting a wide range of administrative and data-related operations across different versions (V1Alpha, V1Beta) and resource types. For the selected Resource "Data (V1Alpha) - Report Task" and Operation "Get Report Task," the node retrieves details about a specific report task within a Google Analytics property.

Typical use cases include:

  • Fetching the status or metadata of a previously created report task.
  • Monitoring report generation progress.
  • Retrieving report task information for further processing or analysis in workflows.

For example, a user might create a report task to generate analytics data asynchronously and then use this node operation to check the task's completion status or retrieve its results.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property under which the report task exists.
Report Task ID The unique identifier of the report task to retrieve.
Query Parameters Optional parameters to filter or paginate the request. Includes:
- Calculated Metric ID: ID for a calculated metric.
- Entity: Level of data access report (property or account).
- Filter: Expression to filter results.
- Names: Names of access bindings to retrieve.
- Page Size: Maximum number of report tasks to return (default 10).
- Page Token: Token for fetching next page of results.
- Show Deleted: Whether to include soft-deleted properties (default true).
- Universal Analytics Property ID: UA property to look up connected GA4 property.
- Update Mask: List of fields to update (snake case).

Output

The node outputs an array of JSON objects representing the retrieved report task(s). Each object contains the detailed information returned by the Google Analytics API for the specified report task, such as its status, configuration, and metadata.

If multiple items are returned (e.g., when listing report tasks), each item is included as a separate JSON object in the output array.

The node does not output binary data for this operation.

Dependencies

  • Requires valid Google Analytics API credentials configured in n8n using OAuth2 authentication.
  • The node makes authenticated HTTP requests to Google Analytics API endpoints, specifically to URLs under https://analyticsdata.googleapis.com/v1alpha for Data (V1Alpha) resources.
  • Proper permissions on the Google Analytics account/property are necessary to access report tasks.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that OAuth2 credentials for Google Analytics API are properly set up and connected in n8n.
  • Required Parameter Errors: Errors like "Property ID is required" or "Report Task ID is required" indicate missing mandatory inputs. Verify that these fields are correctly filled.
  • API Request Failures: Errors from the Google Analytics API may occur due to invalid IDs, insufficient permissions, or network issues. Review the error message for details and confirm that the account has access to the requested resource.
  • Pagination Issues: When retrieving large lists, use the Page Token and Page Size query parameters to handle pagination correctly.

Links and References

This summary focuses on the "Data (V1Alpha) - Report Task" resource and the "Get Report Task" operation, describing how the node fetches report task details from Google Analytics using provided identifiers and optional query parameters.

Discussion