Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Beta) - Data Stream → Create Data Stream

AI-generated

Overview

This node interacts with the Google Analytics API, specifically supporting a wide range of administrative and data operations. For the Admin (V1Beta) - Data Stream resource, the node can create new data streams within a specified Google Analytics property.

Creating a data stream is useful when you want to start collecting data from a new source such as a website or an app into your Google Analytics property. This operation helps set up the data ingestion pipeline for analytics tracking.

Practical example:

  • You have a new website and want to track user interactions. Using this node, you can create a web data stream under your existing Google Analytics property to start collecting data from that site.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property where the data stream will be created.
Query Parameters Optional parameters to customize the request, including filters, pagination, and others.
Request Body JSON object containing the details of the data stream to create (e.g., type, name, settings).

Details on "Query Parameters" options (optional):

  • 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: Max number of report tasks to return.
  • Page Token: Token for fetching next page.
  • Show Deleted: Include soft-deleted properties.
  • 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 element corresponds to the response from the Google Analytics API for the executed operation.

For the Create Data Stream operation, the output JSON contains the newly created data stream's details as returned by the API. This typically includes identifiers, configuration, and metadata about the data stream.

No binary data output is involved in 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 are necessary to create data streams.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that OAuth2 credentials for Google Analytics API are properly set up and selected.
  • Required Parameter Errors: Errors like "Property ID is required" indicate missing mandatory inputs. Make sure to provide the Property ID when creating a data stream.
  • API Errors: Any error returned by the Google Analytics API will be wrapped and shown with the message prefix "Error calling Google Analytics API." Check the API error details for issues like permission denied, invalid request body, or quota limits.
  • Network Issues: Ensure network connectivity to Google's API endpoints and that no firewall blocks the requests.

Links and References


This summary covers the static analysis of the node's execute method for the "Admin (V1Beta) - Data Stream" resource and "Create Data Stream" operation based on the provided code and properties.

Discussion