Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Alpha) - Property Access Binding → Batch Get Property Access Bindings

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 Admin (V1Alpha) - Property Access Binding resource, the node enables batch retrieval of property access bindings, which are records defining user access permissions to Google Analytics properties.

A common use case for this operation is when an administrator wants to audit or review multiple access bindings associated with a specific Google Analytics property in bulk. This can help in managing user permissions efficiently, ensuring compliance, or preparing reports on who has what level of access.

For example, an admin might use this node to fetch all access bindings for a property to verify that only authorized users have access or to prepare a list of users for an access review process.

Properties

Name Meaning
Property ID The unique identifier of the Google Analytics property whose access bindings are being queried.
Query Parameters Optional parameters to refine the batch get request. These include:
- Calculated Metric ID: ID for a calculated metric to filter or specify.
- Entity: Specifies whether the report is at the property or account level.
- Filter: Expression to filter results.
- Names: Specific names of access bindings to retrieve.
- Page Size: Maximum number of access bindings to return (default 10).
- Page Token: Token for fetching the next page of results (for pagination).
- Show Deleted: Boolean indicating 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), if applicable.

Output

The output is a JSON array where each element corresponds to the response from the Google Analytics API for the batch get property access bindings request. Each item contains detailed information about one or more access bindings, including user permissions and roles associated with the specified property.

The structure typically includes fields such as:

  • Access binding identifiers
  • User or group details
  • Roles and permissions granted
  • Status flags (e.g., active, deleted)

No binary data output is involved in this operation.

Dependencies

  • Requires valid Google Analytics API OAuth2 credentials configured in n8n.
  • The node uses the Google Analytics Admin API endpoint https://analyticsadmin.googleapis.com/v1alpha.
  • Proper OAuth2 authentication setup is mandatory to authorize API requests.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that OAuth2 credentials for Google Analytics API are properly set up and linked in n8n.
  • Required Parameter Errors: Errors like "Property ID is required" indicate that the necessary input parameter was not provided. Verify that the Property ID field is filled.
  • API Request Failures: Network issues, invalid tokens, or insufficient permissions may cause API call failures. Check the API key validity, scopes, and network connectivity.
  • Pagination Handling: If many access bindings exist, use the Page Token and Page Size query parameters to paginate through results correctly.
  • Soft-Deleted Items: If unexpected results appear, check the "Show Deleted" parameter to control inclusion of soft-deleted access bindings.

Links and References

Discussion