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 versions (v1alpha, v1beta) and data types. For the selected resource "Admin (V1Alpha) - Calculated Metric" and operation "List Calculated Metrics," it lists all calculated metrics defined within a specified Google Analytics property.

Use cases include:

  • Retrieving all calculated metrics for a given property to analyze or audit custom metrics.
  • Automating reporting workflows that require fetching metric definitions.
  • Integrating Google Analytics calculated metrics into broader data pipelines or dashboards.

Example: You want to get a list of all calculated metrics configured in your GA4 property to verify their setup or use them in further analysis.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property from which to list calculated metrics.
Query Parameters Optional filters and pagination controls for the request, including:
- Calculated Metric ID: Filter by specific calculated metric ID.
- Entity: Specify data access report level (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 where each item represents a calculated metric object as returned by the Google Analytics Admin API. Each object typically includes details such as the metric's ID, name, expression, description, and other metadata related to the calculated metric.

No binary data output is involved.

Dependencies

  • Requires an OAuth2 credential for Google Analytics API authentication.
  • The node uses the Google Analytics Admin API endpoints, specifically the v1alpha version for calculated metrics.
  • Proper permissions on the Google Analytics property are necessary to list calculated metrics.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure you have configured and selected valid OAuth2 credentials with appropriate scopes.
  • Required Parameter Errors: Errors like "Property ID is required" indicate missing mandatory inputs; verify that the Property ID is provided.
  • API Request Failures: Errors returned from the Google Analytics API will be surfaced with messages prefixed by "Error calling Google Analytics API." Check the error message and stack trace for details.
  • Pagination Issues: When retrieving large sets of calculated metrics, use the Page Size and Page Token query parameters to paginate through results properly.

Links and References

Discussion