Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Alpha) - Property → Update Property

AI-generated

Overview

This node integrates with the Google Analytics API, specifically targeting the Admin (V1Alpha) resource for managing properties. The "Update Property" operation allows users to update various settings and attributes of a Google Analytics property within an account. This is useful for administrators who need to programmatically modify property configurations such as data retention, attribution settings, or other property-level details.

Common scenarios include:

  • Automating updates to property settings across multiple accounts.
  • Integrating property management into larger workflows that involve Google Analytics data.
  • Updating specific fields of a property without manual intervention in the Google Analytics UI.

Example: Automatically updating the data retention settings of a property based on compliance requirements.

Properties

Name Meaning
Property ID The unique identifier of the Google Analytics property to update.
Query Parameters Optional parameters to refine 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 report tasks to return.
- Page Token: Token for fetching next page of results.
- Show Deleted: Whether to include soft-deleted properties.
- Universal Analytics Property ID: UA property to look up connected GA4 property.
- Update Mask: Comma-separated list of snake_case field names to update.
Request Body JSON object containing the fields and values to update on the property.

Output

The node outputs a JSON array where each element corresponds to the response from the Google Analytics API for the update request. The structure of the JSON output matches the updated property resource returned by the API, typically including the updated fields and metadata about the property.

No binary data output is involved.

Dependencies

  • Requires an OAuth2 credential configured for Google Analytics API access.
  • The node uses the Google Analytics Admin API endpoint https://analyticsadmin.googleapis.com/v1alpha.
  • Proper permissions on the Google Analytics account and property are necessary to perform update operations.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that the OAuth2 credentials for Google Analytics are properly set up and selected.
  • Required Parameter Errors: Errors like "Property ID is required" indicate missing mandatory input. Verify that the Property ID is provided.
  • API Errors: Errors returned from the Google Analytics API will be wrapped with the message "Error calling Google Analytics API" followed by the API error message. Check the API quota, permissions, and validity of the request body.
  • Invalid Update Mask: If using the update mask, ensure field names are in snake_case and correspond to valid updatable fields.

Links and References

Discussion