Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Alpha) - Property Access Binding → List Property Access Bindings

AI-generated

Overview

This node integrates with the Google Analytics API, specifically targeting the Admin (V1Alpha) resource for Property Access Bindings. The "List Property Access Bindings" operation allows users to retrieve a list of access bindings associated with a specific Google Analytics property. This is useful for managing and auditing user permissions and access controls within a Google Analytics property.

Common scenarios include:

  • Auditing who has access to a particular property.
  • Managing user roles and permissions programmatically.
  • Integrating access control data into broader workflows or reports.

For example, a marketing team lead might use this node to fetch all current access bindings on a property to ensure only authorized users have access before launching a campaign.

Properties

Name Meaning
Property ID The unique identifier of the Google Analytics property for which to list access bindings.
Query Parameters Optional filters and pagination parameters to refine the list request. Includes:
- Calculated Metric ID: Filter by calculated metric ID.
- Entity: Specify if the report is at property or account level.
- Filter: Expression to filter results.
- Names: Names of access bindings to retrieve.
- Page Size: Maximum number of results to return (default 10).
- Page Token: Token for fetching the next page of results.
- Show Deleted: Whether to include soft-deleted ("trashed") properties (default true).
- Universal Analytics Property ID: UA property to look up connected GA4 property.
- Update Mask: List of fields to update (in snake case).

Output

The output is a JSON array containing the list of property access bindings retrieved from the Google Analytics API. Each item in the array represents an access binding object with details about the user's access rights to the specified property.

The structure typically includes:

  • User or group identifiers.
  • Roles or permissions granted.
  • Status information (active, deleted, etc.).
  • Metadata related to the access binding.

No binary data is output by this node.

Dependencies

  • Requires a valid Google Analytics API OAuth2 credential configured in n8n.
  • The node makes authenticated HTTP requests to the Google Analytics Admin API endpoint https://analyticsadmin.googleapis.com/v1alpha.
  • Proper permissions on the Google Analytics account are necessary to list access bindings.

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 connected.
  • Required Parameter Errors: Errors like "Property ID is required" indicate that mandatory input parameters were not provided. Verify that the Property ID field is filled.
  • API Request Failures: Errors returned from the Google Analytics API will be surfaced with messages prefixed by "Error calling Google Analytics API." Check the error message and stack trace for details.
  • Pagination Issues: When retrieving large lists, use the Page Token and Page Size query parameters correctly to paginate through results.

Links and References

This summary covers the static analysis of the node's execute method for the "Admin (V1Alpha) - Property Access Binding" resource and the "List Property Access Bindings" operation based on the provided source code and property definitions.

Discussion