Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Alpha) - Expanded Data Set → Update Expanded Data Set

AI-generated

Overview

This node integrates with the Google Analytics API, specifically targeting the Admin (V1Alpha) resource for managing Expanded Data Sets. The "Update Expanded Data Set" operation allows users to modify existing expanded data sets within a Google Analytics property. This is useful for analytics administrators who want to update configurations or metadata of expanded data sets to better tailor their analytics data collection and reporting.

Common scenarios include:

  • Updating the configuration of an expanded data set to reflect new business requirements.
  • Modifying metadata or filters associated with an expanded data set.
  • Managing data enrichment by adjusting expanded data sets programmatically.

Example: An analytics admin wants to update the dimensions or metrics included in an expanded data set to capture additional user behavior insights. Using this node, they can specify the property and expanded data set IDs along with the updated configuration in the request body.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property that owns the expanded data set.
Expanded Data Set ID The unique identifier of the expanded data set to update.
Query Parameters Optional parameters to customize the request, including:
- Calculated Metric ID: ID for a calculated metric to use.
- 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: List of fields to be updated (in snake case).
Request Body JSON object containing the updated data set configuration and fields to patch.

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 expanded data set resource as returned by the API, including all its fields after modification.

If the API supports binary data output for this operation (not indicated here), it would typically represent files or media related to the data set, but this node focuses on JSON responses.

Dependencies

  • Requires valid Google Analytics API OAuth2 credentials configured in n8n.
  • The node uses the Google Analytics Admin API v1alpha endpoint (https://analyticsadmin.googleapis.com/v1alpha).
  • Proper permissions on the Google Analytics property are necessary to perform update operations on expanded data sets.

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 authorized.
  • Required Parameter Errors: Errors like "Property ID is required" or "Expanded Data Set ID is required" indicate missing mandatory inputs. Verify that these IDs are correctly provided.
  • API Errors: 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 insufficient permissions, invalid IDs, or malformed request bodies.
  • Update Mask Usage: When using updateMask in query parameters, ensure field names are in snake_case and correspond exactly to the API's expected fields to avoid partial updates failing.

Links and References

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

Discussion