Google Analytics

Overview

This node integrates with the Google Analytics API, specifically targeting the Admin (V1Alpha) resource for managing Custom Metrics. The "Update Custom Metric" operation allows users to modify existing custom metrics within a specified Google Analytics property. This is useful for analytics administrators who want to adjust metric definitions or attributes without recreating them.

Common scenarios include:

• Updating the configuration of a custom metric to reflect changes in business requirements.
• Modifying metric properties such as name, description, or measurement units.
• Automating updates to multiple custom metrics across different properties.

Example: An analytics team wants to update the display name and scope of a custom metric used in reports. Using this node, they can programmatically apply these changes by specifying the property ID, custom metric ID, and the updated fields in the request body.

Properties

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 reflects the updated custom metric resource as returned by the API, typically including fields like metric name, description, measurement unit, and other metadata.

No binary data output is produced by this node.

Dependencies

• Requires an OAuth2 API 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 property are necessary to update custom metrics.

Troubleshooting

• Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that a valid OAuth2 credential for Google Analytics is configured and selected.
• Required Parameter Errors: Errors like "Property ID is required" or "Custom Metric ID is required" indicate missing essential inputs. Verify that these IDs are correctly provided.
• API Errors: Errors returned from the Google Analytics API will be wrapped and shown with the message prefix "Error calling Google Analytics API." Check the error details for issues such as insufficient permissions, invalid IDs, or malformed request bodies.
• Update Mask Usage: When using the updateMask query parameter, ensure field names are in snake_case and correspond exactly to the API's expected fields to avoid partial or failed updates.

Links and References

• Google Analytics Admin API Documentation
• Custom Metrics Management Guide
• Google Analytics API OAuth2 Setup