Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Alpha) - Property Access Binding → Batch Delete 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. The "Batch Delete Property Access Bindings" operation under the "Admin (V1Alpha) - Property Access Binding" resource allows users to delete multiple property access bindings in a single batch request. This is useful for managing user permissions efficiently by removing several access bindings at once rather than individually.

Common scenarios include:

  • Revoking access for multiple users or service accounts from a Google Analytics property.
  • Cleaning up outdated or unnecessary access bindings in bulk.
  • Automating permission management workflows where multiple deletions are required simultaneously.

Example: An admin wants to remove access for a list of users who no longer require access to a specific Google Analytics property. Using this batch delete operation, they can specify all relevant access bindings in one request, streamlining the process.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property for which the access bindings are managed.
Query Parameters Optional parameters to filter or control the request, including:
- Calculated Metric ID: ID for calculated metrics
- 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 pagination
- Show Deleted: Whether to include soft-deleted properties
- Universal Analytics Property ID: UA property linked to GA4 property
- Update Mask: List of fields to update (snake case)
Request Body JSON object containing the batch delete request details, typically specifying the access bindings to delete.

Output

The output is a JSON array containing the parsed response from the Google Analytics API after performing the batch delete operation. It reflects the result of the deletion request, such as confirmation of deleted access bindings or any errors encountered.

If the operation succeeds, the output confirms the batch deletion of specified property access bindings. If there are errors, the output will contain error details.

No binary data output is involved in this operation.

Dependencies

  • Requires an OAuth2 API credential for Google Analytics API authentication.
  • The node uses the Google Analytics Admin API endpoint https://analyticsadmin.googleapis.com/v1alpha.
  • Proper permissions on the Google Analytics property are necessary to perform batch deletions of access bindings.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that valid OAuth2 credentials for Google Analytics API are configured in n8n.
  • Required Parameter Errors: Errors like "Property ID is required" indicate missing mandatory input. Verify that the Property ID and other required IDs are 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 API response for details such as insufficient permissions or invalid IDs.
  • Invalid JSON in Request Body: Ensure the JSON provided in the Request Body field is well-formed; otherwise, parsing errors may occur.
  • Network Issues: Connectivity problems to the Google Analytics API endpoint can cause failures. Verify network access and proxy settings if applicable.

Links and References

This summary focuses on the "Batch Delete Property Access Bindings" operation within the "Admin (V1Alpha) - Property Access Binding" resource, describing its purpose, inputs, outputs, dependencies, and common troubleshooting points based on static analysis of the provided source code and property definitions.

Discussion