Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Data (V1Alpha) - Report Task → Query Report Task

AI-generated

Overview

This node integrates with the Google Analytics API, specifically supporting a wide range of administrative and data-related operations across different API versions (v1alpha, v1beta) and resources. For the selected resource "Data (V1Alpha) - Report Task" and operation "Query Report Task," it allows users to retrieve detailed report task data for a specified property.

Typical use cases include:

  • Querying the status or results of a previously created report task in Google Analytics.
  • Automating retrieval of analytics reports for further processing or integration.
  • Managing and monitoring report tasks programmatically within workflows.

For example, a user might create a report task to generate a custom analytics report and then use this node to query the task's progress or fetch its output once completed.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property for which the report task is managed.
Report Task ID The unique identifier of the specific report task to query.
Query Parameters Optional parameters to refine the query, including:
- Calculated Metric ID: ID for a calculated metric to use.
- 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).
Request Body JSON object for request body payload if required by the operation (not typically used here).

Output

The node outputs an array of JSON objects representing the response from the Google Analytics API for the queried report task. The structure corresponds directly to the API's response schema for report tasks, typically including details such as:

  • Report task metadata (ID, creation time, status).
  • Report results or references to where results can be accessed.
  • Any error or status messages related to the report task.

No binary data output is indicated for this operation.

Dependencies

  • Requires valid Google Analytics API OAuth2 credentials configured in n8n.
  • Uses the Google Analytics Data API endpoints (https://analyticsdata.googleapis.com/v1alpha).
  • Network connectivity to Google APIs is necessary.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that OAuth2 credentials for Google Analytics are properly set up and linked in n8n.
  • Required Parameter Errors: Errors like "Property ID is required" or "Report Task ID is required" indicate missing mandatory inputs; verify all required fields are filled.
  • API Request Failures: Errors returned from the Google API will be wrapped with "Error calling Google Analytics API" and include the original message. Check the API quota, permissions, and validity of IDs used.
  • Pagination Issues: When using Page Token and Page Size, ensure tokens are correctly handled to paginate through large result sets.

Links and References

This summary focuses on the "Data (V1Alpha) - Report Task" resource and the "Query Report Task" operation, describing how the node constructs the API request, required inputs, and expected outputs based on static code analysis.

Discussion