Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Beta) - Data Stream → List Data Streams

AI-generated

Overview

This node integrates with the Google Analytics API, specifically targeting the Admin (V1Beta) Data Stream resource for the "List Data Streams" operation. It allows users to retrieve a list of data streams associated with a specified Google Analytics property. This is useful for managing and auditing data streams within an analytics property, such as web or app data streams.

Common scenarios include:

  • Fetching all data streams under a particular property to analyze or manage them.
  • Automating reporting or synchronization tasks that require knowledge of existing data streams.
  • Integrating Google Analytics data stream information into workflows for monitoring or configuration purposes.

Example use case:

  • A marketing analyst wants to automatically retrieve all data streams for a property to verify their configurations regularly.
  • A developer automates the process of listing data streams before creating new ones to avoid duplicates.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property whose data streams are to be listed.
Query Parameters Optional parameters to filter or paginate the list request. Includes:
- Calculated Metric ID: ID for a calculated metric (string).
- Entity: Level of data access report (property or account level) (string).
- Filter: Expression to filter results (string).
- Names: Names of access bindings to retrieve (string).
- Page Size: Maximum number of results to return (number, default 10).
- Page Token: Token for fetching next page of results (string).
- Show Deleted: Whether to include soft-deleted properties (boolean, default true).
- Universal Analytics Property ID: UA property to look up connected GA4 property (string).
- Update Mask: List of fields to update (snake_case string).

Output

The node outputs a JSON array where each item corresponds to the response from the Google Analytics API for the requested operation. For the "List Data Streams" operation, the output JSON contains the list of data streams under the specified property, including details such as stream IDs, names, types, and other metadata provided by the API.

No binary data output is involved in this operation.

Dependencies

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

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that a valid OAuth2 credential for Google Analytics is configured and selected.
  • Required Parameter Missing: Errors like "Property ID is required" indicate that the mandatory property ID input was not provided. Make sure to specify the property ID.
  • API Request Failures: Errors returned from the Google Analytics API will be wrapped and shown with the message prefix "Error calling Google Analytics API." Check the error message for details such as permission issues, invalid IDs, or quota limits.
  • Pagination Issues: When retrieving large lists, use the "Page Token" query parameter to fetch subsequent pages if not all results are returned at once.

Links and References

This summary focuses on the "Admin (V1Beta) - Data Stream" resource and the "List Data Streams" operation as requested.

Discussion