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-related operations across different versions (v1alpha, v1beta) and resource types. For the selected Resource "Admin (V1Alpha) - Data Stream" and Operation "Get Data Stream Enhanced Measurement Settings," the node retrieves the enhanced measurement settings for a specified data stream within a Google Analytics property.

This operation is useful when you want to programmatically access or audit the enhanced measurement configuration of a data stream, which controls automatic tracking features such as page views, scrolls, outbound clicks, site search, video engagement, and file downloads.

Practical example:

  • Automatically fetch enhanced measurement settings for a web data stream to verify if certain events are enabled before running analytics reports or audits.
  • Integrate this retrieval into workflows that manage or monitor Google Analytics configurations at scale.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property containing the data stream.
Data Stream ID The identifier of the specific data stream within the property whose enhanced measurement settings are to be retrieved.
Query Parameters Optional additional parameters for filtering or pagination (not typically used for this operation).

Details on Query Parameters (optional)

  • Calculated Metric ID: ID for calculated metrics (not relevant here).
  • Entity: Level of data access report (property/account).
  • Filter: Expression to filter results.
  • Names: Names of access bindings to retrieve.
  • Page Size: Max number of items to return.
  • Page Token: Token for next page in paginated results.
  • Show Deleted: Whether to include soft-deleted properties.
  • Universal Analytics Property ID: UA property to look up connected GA4 property.
  • Update Mask: Fields to update (snake case).

For this operation, these query parameters are generally not required.

Output

The output JSON contains the enhanced measurement settings object for the specified data stream. This includes configuration details about which automatic event measurements are enabled or disabled.

The exact structure corresponds to the Google Analytics Admin API's response for enhancedMeasurementSettings, typically including fields like:

  • streamEnabled: Boolean indicating if enhanced measurement is enabled.
  • pageViewsEnabled, scrollsEnabled, outboundClicksEnabled, etc.: Booleans for individual event types.
  • Other configuration details related to enhanced measurement.

No binary data output is involved.

Dependencies

  • Requires an OAuth2 credential configured for Google Analytics API access.
  • The node uses the Google Analytics Admin API endpoint https://analyticsadmin.googleapis.com/v1alpha.
  • Proper permissions on the Google Analytics account/property are necessary to read data stream settings.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that a valid OAuth2 credential for Google Analytics API is configured and selected.
  • Required Parameter Errors: The node requires both Property ID and Data Stream ID for this operation. Missing either will cause errors like "Property ID is required" or "Data Stream ID is required."
  • API Permission Errors: Insufficient permissions on the Google Analytics account or property may result in authorization errors.
  • Invalid IDs: Providing incorrect or non-existent Property or Data Stream IDs will cause API errors; verify IDs in Google Analytics UI or via API.
  • Network or API Errors: Standard HTTP or API errors may occur; check error messages for details.

Links and References

This summary focuses on the "Admin (V1Alpha) - Data Stream" resource and the "Get Data Stream Enhanced Measurement Settings" operation as requested.

Discussion