Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Data (V1Alpha) - Audience List → Get Audience List

AI-generated

Overview

This node interacts 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) - Audience List" and Operation "Get Audience List," it retrieves detailed information about a specific audience list within a Google Analytics property.

Typical use cases include:

  • Fetching details of an existing audience list to analyze or use in marketing campaigns.
  • Integrating audience data retrieval into automated workflows for reporting or synchronization with other systems.
  • Managing audience lists programmatically as part of larger analytics or advertising automation.

Example: You want to get the configuration and metadata of a particular audience list identified by its ID within a Google Analytics property to update your CRM segmentation.

Properties

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

Output

The node outputs a JSON array where each item corresponds to the response from the Google Analytics API for the requested audience list. The JSON structure contains all details of the audience list as returned by the API, such as audience definitions, membership duration, filters, and metadata.

No binary data output is involved.

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 access audience list data.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that OAuth2 credentials for Google Analytics API are properly set up and connected.
  • Required Parameter Missing: Errors like "Property ID is required" or "Audience List ID is required" indicate mandatory inputs were not provided. Verify these fields are filled.
  • API Request Failures: Errors returned from the Google Analytics API will be wrapped and shown with the message "Error calling Google Analytics API." Check the error description for details such as permission issues, invalid IDs, or quota limits.
  • Pagination Issues: When using query parameters like pageToken, ensure tokens are correctly passed to fetch subsequent pages.

Links and References

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

Discussion