Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

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

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 selected Resource "Data (V1Alpha) - Recurring Audience List" and Operation "Get Recurring Audience List," the node retrieves details about a specific recurring audience list within a Google Analytics property.

This functionality is useful for marketers and analysts who want to programmatically access recurring audience lists configured in their Google Analytics properties, enabling automation of audience management workflows or integration with other marketing tools.

Example use cases:

  • Automatically fetch recurring audience list details to sync with advertising platforms.
  • Monitor audience list configurations as part of an analytics reporting pipeline.
  • Integrate audience data retrieval into broader customer segmentation workflows.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property containing the recurring audience list.
Recurring Audience List ID The unique identifier of the recurring audience list to retrieve.
Query Parameters Optional parameters to refine 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 results to return (default 10).
- Page Token: Token for fetching next page of results.
- Show Deleted: Whether to include soft-deleted ("trashed") properties (default true).
- Universal Analytics Property ID: UA property to look up connected GA4 property.
- Update Mask: Fields to update (snake case).

Output

The node outputs a JSON array where each element corresponds to the response from the Google Analytics API for the requested recurring audience list. The JSON structure matches the API's response schema for a recurring audience list, typically including fields such as:

  • Audience list metadata (name, description, status)
  • Configuration details (membership duration, filters)
  • Associated property information
  • Creation and update timestamps

No binary data output is involved.

Dependencies

  • Requires valid Google Analytics API OAuth2 credentials configured in n8n.
  • Uses the Google Analytics Data API endpoint https://analyticsdata.googleapis.com/v1alpha for this resource.
  • The node depends on network connectivity to Google's 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 authorized in n8n.
  • Required Parameter Errors: Errors like "Property ID is required" or "Recurring Audience List ID is required" indicate missing mandatory inputs. Verify these fields are correctly filled.
  • API Request Failures: Network issues or invalid permissions can cause API call failures. Check API quotas, permissions, and network connectivity.
  • 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) - Recurring Audience List" resource and the "Get Recurring Audience List" operation as requested.

Discussion