Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Data (V1Beta) - Property → Batch Run Reports

AI-generated

Overview

This node integrates with the Google Analytics API, specifically supporting a wide range of administrative and data operations across different API versions (v1alpha, v1beta) and resource types. The "Batch Run Reports" operation under the "Data (V1Beta) - Property" resource allows users to run multiple reports in a single batch request for a specified property.

Common scenarios where this node is beneficial include:

  • Automating retrieval of multiple analytics reports simultaneously to optimize API usage.
  • Aggregating various report data for comprehensive analysis or dashboarding.
  • Managing Google Analytics properties and related resources programmatically within workflows.

For example, a marketing analyst could use this node to batch request several performance reports for a website property, reducing the number of API calls and simplifying data collection.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property for which the batch reports will be run.
Query Parameters Optional parameters to customize the request, 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 containing the batch report request details as per Google Analytics API schema.

Output

The node outputs an array of JSON objects representing the responses from the Google Analytics API for each batch report requested. Each item corresponds to one report result returned by the batch operation.

If the API returns binary data (not typical for reporting endpoints), it would be included accordingly, but this operation primarily deals with JSON report data.

Dependencies

  • Requires valid Google Analytics API OAuth2 credentials configured in n8n.
  • Uses the Google Analytics Data API endpoints (analyticsdata.googleapis.com) for data operations.
  • Requires network access to Google APIs.

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 selected.
  • Required Parameter Errors: Many operations require specific IDs (e.g., Property ID). Missing these will cause errors like "Property ID is required." Verify all mandatory fields are filled.
  • API Rate Limits: Batch requests reduce calls but still subject to Google API quotas. Monitor quota usage to avoid throttling.
  • Invalid JSON in Request Body: Ensure the JSON provided in the Request Body field is well-formed; otherwise, parsing errors may occur.
  • Network Issues: Connectivity problems can cause request failures; verify internet access and firewall settings.

Links and References

This summary focuses on the "Batch Run Reports" operation under the "Data (V1Beta) - Property" resource, describing its purpose, inputs, outputs, dependencies, and common troubleshooting tips based on static code analysis of the node implementation.

Discussion