Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Beta) - Custom Dimension → Update Custom Dimension

AI-generated

Overview

This node integrates with the Google Analytics API, specifically targeting the Admin (V1Beta) resource for managing Custom Dimensions within a property. The "Update Custom Dimension" operation allows users to modify existing custom dimensions associated with a specified Google Analytics property.

Common scenarios where this node is beneficial include:

  • Updating metadata or configuration of custom dimensions used in analytics reports.
  • Automating the management of custom dimensions across multiple properties.
  • Integrating Google Analytics custom dimension updates into broader workflows, such as data governance or marketing automation.

For example, a user might update the scope or description of a custom dimension to reflect changes in tracking requirements without manually accessing the Google Analytics interface.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property that contains the custom dimension to update.
Custom Dimension ID The identifier of the specific custom dimension to update within the property.
Query Parameters Optional parameters to customize the request, including:
- Calculated Metric ID: ID for a calculated metric (string).
- Entity: Level of data access report (property or account level) (string).
- Filter: Expression to filter results (string).
- Names: Names of access bindings to retrieve (string).
- Page Size: Maximum number of report tasks to return (number).
- Page Token: Continuation token for pagination (string).
- Show Deleted: Include soft-deleted properties (boolean).
- Universal Analytics Property ID: UA property to look up connected GA4 property (string).
- Update Mask: Comma-separated list of fields to update in snake_case (string).
Request Body JSON object containing the fields and values to update on the custom dimension.

Output

The node outputs a JSON array where each element corresponds to the response from the Google Analytics API for the update operation. The JSON structure represents the updated custom dimension resource, typically including fields such as:

  • The custom dimension's ID.
  • Updated attributes like name, description, scope, and other configuration details.

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/v1beta.
  • Proper permissions on the Google Analytics property are necessary to perform update operations on custom dimensions.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing credentials, ensure that a valid Google Analytics OAuth2 credential is configured and selected.
  • Required Parameter Errors: Errors indicating missing "Property ID" or "Custom Dimension ID" mean these inputs must be provided for the update operation.
  • API Errors: Errors returned from the Google Analytics API may indicate permission issues, invalid field names in the update mask, or malformed request body JSON. Verify the correctness of input parameters and the request body format.
  • Update Mask Usage: If only certain fields should be updated, use the updateMask query parameter with correct snake_case field names; otherwise, the entire resource may be overwritten.

Links and References

This summary is based solely on static analysis of the provided source code and property definitions.

Discussion