Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Data (V1Alpha) - Audience List → List Audience Lists

AI-generated

Overview

This node integrates with the Google Analytics API, specifically targeting the "Data (V1Alpha) - Audience List" resource to perform operations related to audience lists within a Google Analytics property. The "List Audience Lists" operation retrieves a list of audience lists associated with a specified property.

Common scenarios for this node include:

  • Retrieving all audience lists configured in a Google Analytics property for analysis or reporting.
  • Automating workflows that require fetching audience data to sync with marketing platforms or CRM systems.
  • Managing and auditing audience configurations programmatically.

For example, a marketer might use this node to fetch all audience lists from their Google Analytics property to update targeted advertising campaigns dynamically.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property whose audience lists are to be listed.
Query Parameters Optional parameters to filter or paginate the results. 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 audience lists to return (default 10).
- Page Token: Token for fetching the 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 be updated (in snake case).

Output

The node outputs a JSON array where each item represents an audience list retrieved from the specified Google Analytics property. Each audience list object contains details as returned by the Google Analytics API, such as audience identifiers, names, descriptions, and other metadata relevant to the audience configuration.

No binary data output is involved in this operation.

Dependencies

  • Requires valid Google Analytics API credentials with OAuth2 authentication.
  • The node uses the Google Analytics Data API endpoint https://analyticsdata.googleapis.com/v1alpha.
  • Proper permissions on the Google Analytics property are necessary to list audience lists.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing credentials, ensure that a valid Google Analytics OAuth2 API credential is configured in n8n.
  • Property ID Required: The operation requires a Property ID; if omitted, the node will throw an error indicating this requirement.
  • API Errors: Errors returned from the Google Analytics API (e.g., permission denied, invalid parameters) will be surfaced with descriptive messages. Verify API access rights and parameter correctness.
  • Pagination Issues: When dealing with large numbers of audience lists, use the Page Token and Page Size query parameters to paginate through results properly.

Links and References

This summary focuses on the "List Audience Lists" operation under the "Data (V1Alpha) - Audience List" resource, describing its purpose, inputs, outputs, dependencies, and common troubleshooting points based on static code analysis.

Discussion