Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Alpha) - Property → Create Property

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 "Admin (V1Alpha) - Property" resource with the "Create Property" operation allows users to create new properties within a Google Analytics account.

Typical use cases include automating the creation and configuration of Google Analytics properties as part of a larger workflow, managing analytics accounts programmatically, or integrating property creation into deployment pipelines. For example, a marketing team could automate setting up new properties for different websites or apps without manual intervention.

Properties

Name Meaning
Query Parameters A collection of optional parameters to customize the API request. Includes:
- 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: Max number of report tasks to return (default 10)
- Page Token: Continuation token for pagination
- Show Deleted: Include soft-deleted ("trashed") properties (boolean, default true)
- 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 property to create. This is the main payload sent to the API.

Output

The node outputs an array of JSON objects representing the response from the Google Analytics API for the requested operation. For the "Create Property" operation, this will typically be the newly created property's details as returned by the API.

If the API returns binary data (not typical for property creation), it would be included in the output accordingly, but this operation primarily deals with JSON data.

Dependencies

  • Requires valid Google Analytics API OAuth2 credentials configured in n8n.
  • Uses the Google Analytics Admin API endpoint https://analyticsadmin.googleapis.com/v1alpha for v1alpha resources.
  • The node dynamically constructs API URLs based on the selected resource and operation.
  • Proper permissions on the Google Analytics account are necessary to create properties.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that OAuth2 credentials for Google Analytics are properly set up and connected.
  • Required Parameter Errors: Many operations require specific IDs (e.g., Property ID, Account ID). Missing these will cause errors like "Property ID is required." Double-check that all mandatory fields are filled.
  • API Errors: Errors returned from the Google Analytics API are wrapped and presented with messages like "Error calling Google Analytics API: [message]." Review the message and stack trace for details.
  • Invalid JSON in Request Body: Ensure the JSON provided in the "Request Body" field is valid; otherwise, parsing errors will occur.
  • Permission Issues: Insufficient permissions on the Google Analytics account can cause authorization errors.

Links and References

This summary focuses on the "Admin (V1Alpha) - Property" resource and the "Create Property" operation, describing how the node constructs requests, required inputs, and expected outputs.

Discussion