Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Data (V1Beta) - Audience Export → List Audience Exports

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 (V1Beta) - Audience Export" and operation "List Audience Exports," it allows users to retrieve a list of audience export records associated with a specified Google Analytics property.

Common scenarios for this node include:

  • Managing and retrieving audience export data for analysis or integration with other systems.
  • Automating workflows that require periodic fetching of audience export lists.
  • Integrating Google Analytics audience export data into broader marketing or reporting pipelines.

Practical example:

  • A marketer wants to automate the retrieval of all audience exports for a specific property to sync with a CRM system. This node can be configured to list all audience exports, optionally filtered or paginated, enabling seamless data flow.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property for which to list audience exports.
Query Parameters Optional parameters to refine the request, including:
- Calculated Metric ID: ID for a calculated metric to filter or specify in the query.
- Entity: Level of data access report (property or account level).
- Filter: Expression to filter results.
- Names: Names of access bindings to retrieve.
- Page Size: Maximum number of audience exports to return (default 10).
- Page Token: Token for fetching the next page of results (for pagination).
- Show Deleted: Boolean to include soft-deleted ("trashed") properties in results.
- Universal Analytics Property ID: UA property to look up connected GA4 property.
- Update Mask: List of fields to update (in snake case).

Output

The node outputs a JSON array where each item represents an audience export record retrieved from the Google Analytics API. The structure corresponds directly to the API response for listing audience exports under the specified property.

  • The json output contains detailed information about each audience export, such as IDs, status, creation timestamps, and other metadata as provided by the Google Analytics API.
  • No binary data output is produced by this operation.

Dependencies

  • Requires valid Google Analytics API OAuth2 credentials configured in n8n.
  • The node uses the Google Analytics Data API endpoints corresponding to the selected resource and operation.
  • Network access to https://analyticsdata.googleapis.com/v1beta is required for the "Data (V1Beta)" resources.
  • Proper permissions on the Google Analytics account/property are necessary to perform the requested operations.

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 authorized.
  • Required Parameter Errors: Errors like "Property ID is required" indicate missing mandatory input; verify that the Property ID is correctly provided.
  • API Request Failures: Errors returned from the Google Analytics API will be wrapped and shown with the message prefix "Error calling Google Analytics API." Check the error details for issues such as insufficient permissions, invalid IDs, or malformed query parameters.
  • Pagination Issues: When using Page Token for pagination, ensure tokens are correctly passed between executions to fetch subsequent pages.
  • Filtering Syntax: Incorrect filter expressions may cause API errors; validate filter syntax according to Google Analytics API documentation.

Links and References

If you need further details on other operations or resources, feel free to ask!

Discussion