Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Alpha) - Property → Provision Subproperty

AI-generated

Overview

This node integrates with the Google Analytics API, specifically supporting a wide range of administrative and data management operations across different versions (v1alpha, v1beta) and resource types. The "Provision Subproperty" operation under the "Admin (V1Alpha) - Property" resource allows users to create a subproperty within an existing Google Analytics property. This includes automatically creating a subproperty event filter that applies to the newly created subproperty.

Use cases for this node include automating Google Analytics account and property management tasks such as provisioning new subproperties, managing access bindings, running reports, and updating configurations programmatically. For example, marketing teams or analytics administrators can automate the setup of new tracking properties and their associated filters without manual intervention in the Google Analytics UI.

Properties

Name Meaning
Query Parameters A collection of optional parameters to customize the request, including:
- Calculated Metric ID: ID for a calculated metric
- 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 report tasks to return
- Page Token: Continuation token for pagination
- Show Deleted: Whether to include soft-deleted ("trashed") properties
- Universal Analytics Property ID: UA property to look up connected GA4 property
- Update Mask: List of fields to update (snake case)
Request Body JSON object containing the details of the subproperty to be provisioned. This is the main payload for the creation request.

Output

The node outputs a JSON array where each element corresponds to the parsed JSON response from the Google Analytics API for the executed operation. For the "Provision Subproperty" operation, the output JSON will contain the details of the newly created subproperty along with its associated event filter.

No binary data output is produced by this node.

Dependencies

  • Requires valid Google Analytics API OAuth2 credentials configured in n8n.
  • Uses the Google Analytics Admin API endpoints (https://analyticsadmin.googleapis.com/v1alpha) for administration tasks.
  • The node expects the user to provide necessary identifiers such as Property ID and any other required IDs depending on the operation.

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 Missing: Errors like "Property ID is required" indicate that mandatory input parameters were not provided. Verify all required fields are filled.
  • API Call Failures: Errors returned from the Google Analytics API will be wrapped with messages like "Error calling Google Analytics API." Check the error message and stack trace for details. Common issues include invalid IDs, insufficient permissions, or malformed request bodies.
  • Pagination Issues: When using query parameters like pageToken, ensure correct handling of tokens to paginate through large result sets.

Links and References

This summary focuses on the "Provision Subproperty" operation under the "Admin (V1Alpha) - Property" resource, describing its purpose, inputs, outputs, dependencies, and common troubleshooting tips based on static analysis of the node's source code and provided property definitions.

Discussion