Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions84

Overview

This node integrates with the Google Analytics API, specifically targeting the Admin (V1Alpha) resource for managing Data Streams within a Google Analytics property. The "Get Data Stream" operation retrieves detailed information about a specific data stream associated with a given property.

Typical use cases include:

  • Fetching configuration details of a particular data stream to audit or verify its settings.
  • Integrating Google Analytics data stream metadata into automated workflows for reporting or monitoring.
  • Using the retrieved data stream information as part of a larger analytics or marketing automation process.

For example, a user might want to retrieve the details of a web data stream to check its measurement settings or global site tag configuration before making updates or generating reports.

Properties

Name Meaning
Property ID The unique identifier of the Google Analytics property that owns the data stream.
Data Stream ID The unique identifier of the data stream to retrieve information about.
Query Parameters Optional parameters to refine or filter the request. Includes options like:
- Calculated Metric ID: ID for calculated metrics
- 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 items to return
- Page Token: Token for pagination
- Show Deleted: Whether to include soft-deleted properties
- Universal Analytics Property ID: UA property linked to GA4 property
- Update Mask: List of fields to update (snake case)

Output

The output is a JSON array containing the response from the Google Analytics API for the requested data stream. This typically includes all metadata and configuration details of the specified data stream, such as:

  • Stream type (e.g., web, app)
  • Measurement settings
  • Associated tags or identifiers
  • Any other relevant configuration details provided by the API

No binary data output is involved in this operation.

Dependencies

  • Requires an OAuth2 API 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 retrieve data stream information.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing credentials, ensure that a valid Google Analytics OAuth2 credential is configured and selected.
  • Required Parameter Errors: Errors indicating missing "Property ID" or "Data Stream ID" mean these inputs must be provided for the operation to succeed.
  • API Request Failures: Network issues, insufficient permissions, or invalid IDs can cause API errors. Verify the correctness of IDs and that the authenticated user has access rights.
  • Pagination Issues: When using query parameters like page size or token, ensure correct handling of pagination tokens to avoid incomplete data retrieval.

Links and References


This summary focuses on the "Admin (V1Alpha) - Data Stream" resource and the "Get Data Stream" operation as requested, based on static analysis of the provided source code and input properties.

Discussion