Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Beta) - Data Stream → Update Data Stream

AI-generated

Overview

This node integrates with the Google Analytics API, specifically supporting the Admin (V1Beta) resource for managing data streams within a property. The "Update Data Stream" operation allows users to modify settings or attributes of an existing data stream associated with a Google Analytics property.

Typical use cases include:

  • Updating configuration details of a data stream such as measurement settings or data redaction preferences.
  • Adjusting parameters to reflect changes in tracking requirements without recreating the data stream.
  • Automating updates to multiple data streams across properties in bulk workflows.

For example, a user might update enhanced measurement settings on a web data stream to enable or disable specific event tracking features programmatically.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property that owns the data stream to be updated.
Data Stream ID The identifier of the specific data stream within the property to update.
Query Parameters Optional additional parameters for the request, including:
- 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 items
- Universal Analytics Property ID: UA property linked to GA4 property
- Update Mask: Comma-separated list of fields to update (in snake_case)
Request Body JSON object containing the fields and values to update on the data stream.

Output

The node outputs a JSON array where each element corresponds to the response from the Google Analytics API for the update request. The JSON structure reflects the updated data stream resource as returned by the API, typically including updated attributes and metadata of the data stream.

No binary data output is produced by this operation.

Dependencies

  • Requires valid Google Analytics API OAuth2 credentials configured in n8n.
  • The node uses the Google Analytics Admin API endpoint https://analyticsadmin.googleapis.com/v1beta.
  • Proper permissions on the Google Analytics property and data stream are necessary to perform update operations.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing credentials, ensure that the Google Analytics OAuth2 API credentials are properly set up and connected in n8n.
  • Required Parameter Errors: The node validates required parameters like Property ID and Data Stream ID. Missing these will cause errors. Double-check that these IDs are correctly provided.
  • API Errors: Errors returned from the Google Analytics API (e.g., permission denied, invalid field names in update mask) will be surfaced with descriptive messages. Review the API documentation for correct usage.
  • Malformed JSON in Request Body: Ensure the JSON provided in the Request Body field is valid and matches the expected schema for updating a data stream.

Links and References

Discussion