Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Alpha) - Property Access Binding → Update Property Access Binding

AI-generated

Overview

This node interacts with the Google Analytics API, specifically supporting a wide range of administrative and data-related operations across different versions (v1alpha, v1beta) and resource types. For the selected Resource "Admin (V1Alpha) - Property Access Binding" and Operation "Update Property Access Binding," it updates access bindings for users within a Google Analytics property.

Use cases include managing user permissions and access controls on Google Analytics properties, such as modifying roles or access levels for specific users or groups. This is beneficial in scenarios where you need to programmatically update who can view or manage analytics data for a property.

Example: Updating an existing user's access binding on a property to change their permission level without manually navigating the Google Analytics UI.

Properties

Name Meaning
Property ID The unique identifier of the Google Analytics property where the access binding exists.
Access Binding ID The unique identifier of the specific access binding to update within the property.
Query Parameters Optional parameters to customize the request, including filters, pagination, and update mask.
Request Body JSON object containing the fields and values to update in the property access binding.

Details on Query Parameters options:

  • Calculated Metric ID
  • Entity (property or account level)
  • Filter expression
  • Names of access bindings to retrieve
  • Page Size (number of items per page)
  • Page Token (for pagination continuation)
  • Show Deleted (include soft-deleted properties)
  • Universal Analytics Property ID
  • Update Mask (fields to update, in snake_case)

Output

The node outputs a JSON array where each element corresponds to the response from the Google Analytics API for the executed operation. For the "Update Property Access Binding" operation, the output JSON contains the updated access binding details as returned by the API.

No binary data output is involved.

Dependencies

  • Requires valid Google Analytics API OAuth2 credentials configured in n8n.
  • Uses the Google Analytics Admin API endpoint https://analyticsadmin.googleapis.com/v1alpha.
  • The node performs authenticated HTTP requests using OAuth2 tokens.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that OAuth2 credentials for Google Analytics are properly set up in n8n.
  • Required Parameter Errors: Errors like "Property ID is required" or "Access Binding ID is required" indicate missing mandatory inputs; verify these are provided.
  • API Errors: Any error from the Google Analytics API will be wrapped and reported with the message prefix "Error calling Google Analytics API." Check the detailed error message and stack trace for specifics.
  • Invalid Update Mask: If the update mask field is incorrect or does not match the request body fields, the API may reject the request. Ensure field names in the update mask are in snake_case and correspond exactly to the fields being updated.

Links and References

Discussion