Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Alpha) - Subproperty Event Filter → List Subproperty Event Filters

AI-generated

Overview

This node interacts with the Google Analytics API, specifically targeting the "Admin (V1Alpha) - Subproperty Event Filter" resource to list subproperty event filters within a specified property. It is useful for users who want to retrieve and manage event filters applied to subproperties in their Google Analytics properties.

A common scenario for this node is when an analyst or administrator needs to audit or review all event filters configured on subproperties of a Google Analytics property to ensure data quality or compliance with tracking requirements.

For example, you can use this node to fetch all subproperty event filters for a given property ID to analyze how events are filtered before reporting.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property where the subproperty event filters reside.
Query Parameters Optional parameters to filter or paginate the list request. Includes:
- Calculated Metric ID: ID for a calculated metric to filter by.
- 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: List of fields to update (snake case).

Output

The node outputs a JSON array containing the list of subproperty event filters retrieved from the Google Analytics API for the specified property. Each item in the array represents a subproperty event filter object as returned by the API, including its configuration details.

No binary data output is involved.

Dependencies

  • Requires valid Google Analytics API OAuth2 credentials configured in n8n.
  • The node uses the Google Analytics Admin API v1alpha endpoint (https://analyticsadmin.googleapis.com/v1alpha).
  • Proper permissions on the Google Analytics property are necessary to list subproperty event filters.

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 selected.
  • Required Parameter Errors: Errors like "Property ID is required" indicate that the mandatory Property ID parameter was not provided. Make sure to specify it.
  • API Request Failures: Errors returned from the Google Analytics API will be wrapped with messages like "Error calling Google Analytics API." Check the error message and stack trace for details. Common issues include insufficient permissions or invalid IDs.
  • Pagination Handling: If many subproperty event filters exist, consider using Page Size and Page Token query parameters to paginate through results.

Links and References

Discussion