Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Data (V1Alpha) - Recurring Audience List → List Recurring Audience Lists

AI-generated

Overview

This node integrates 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 Data (V1Alpha) - Recurring Audience List resource, the node allows you to list recurring audience lists associated with a specified property.

Use cases include automating the retrieval of recurring audience lists for analysis or integration with other marketing tools, enabling marketers and analysts to programmatically manage and review audience segments that are updated on a recurring basis.

For example, you might use this node to:

  • Fetch all recurring audience lists for a given Google Analytics property to sync with your CRM.
  • Automate reporting workflows that require up-to-date audience segment information.
  • Integrate audience list data into dashboards or other analytics platforms.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property for which to list recurring audience lists.
Query Parameters Optional parameters to filter or paginate the results. Includes:
- Calculated Metric ID: ID for a calculated metric to filter by.
- 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 results 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: Fields to update (in snake case).

Output

The node outputs an array of JSON objects representing the recurring audience lists retrieved from the Google Analytics API for the specified property.

Each item in the output corresponds to a recurring audience list resource as returned by the API. The exact structure depends on the API response but typically includes details such as audience list identifiers, names, descriptions, and scheduling information for recurrence.

No binary data is output by this node.

Dependencies

  • Requires valid Google Analytics API OAuth2 credentials configured in n8n.
  • The node uses the Google Analytics Data API endpoints (https://analyticsdata.googleapis.com/v1alpha) for the Data (V1Alpha) resources.
  • Proper permissions on the Google Analytics property are necessary to list recurring audience lists.

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: Errors like "Property ID is required" indicate that mandatory input fields were not provided. Make sure to specify the Property ID when listing recurring audience lists.
  • API Request Failures: Errors returned from the Google Analytics API will be surfaced with messages prefixed by "Error calling Google Analytics API." Check the error message and stack trace for details. Common issues include insufficient permissions, invalid IDs, or malformed query parameters.
  • Pagination Handling: When retrieving large sets of recurring audience lists, use the Page Token and Page Size query parameters to paginate through results.

Links and References

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

Discussion