Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions84

Overview

This node interacts with the Google Analytics API, specifically supporting a wide range of administrative and data management operations across different Google Analytics resources. For the selected resource "Admin (V1Alpha) - Channel Group" and operation "List Channel Groups," it retrieves a list of channel groups associated with a specified property.

Use cases include:

  • Managing and auditing channel group configurations within a Google Analytics property.
  • Automating retrieval of channel group metadata for reporting or integration purposes.
  • Integrating Google Analytics channel group data into workflows for marketing analytics or data synchronization.

Example: You want to fetch all channel groups configured in a specific Google Analytics property to analyze how traffic channels are grouped and attributed.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property for which to list channel groups.
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 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: List of fields to update (snake case).

Output

The node outputs a JSON array where each item corresponds to a channel group object retrieved from the Google Analytics API. The exact structure of each channel group object follows the API's response schema for channel groups, typically including identifiers, names, definitions, and other metadata related to channel grouping.

No binary data output is involved.

Dependencies

  • Requires an OAuth2 credential for Google Analytics API authentication.
  • The node uses the Google Analytics Admin API endpoint https://analyticsadmin.googleapis.com/v1alpha.
  • Proper permissions on the Google Analytics property are necessary to list channel groups.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that valid OAuth2 credentials for Google Analytics API are 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 by the Google Analytics API (e.g., permission denied, invalid property ID) will be surfaced with messages prefixed by "Error calling Google Analytics API." Check the provided property ID and user permissions.
  • Pagination Issues: When retrieving large lists, use the "Page Token" and "Page Size" query parameters to handle pagination properly.

Links and References

This summary focuses on the "Admin (V1Alpha) - Channel Group" resource and the "List Channel Groups" operation as requested.

Discussion