Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

User Deletion → Insert or Update a User Deletion Request

AI-generated

Overview

This node interacts with the Google Analytics API, specifically supporting a wide range of administrative and data management operations. For the User Deletion resource, it allows inserting or updating user deletion requests. This is useful for complying with user data privacy regulations by managing requests to delete user data from Google Analytics.

Typical use cases include:

  • Automating user data deletion requests in compliance with GDPR or CCPA.
  • Managing user deletion lifecycle within analytics workflows.
  • Integrating user deletion requests into broader data governance processes.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property related to the user deletion request.
Query Parameters Optional parameters to customize the API request; includes filters, pagination, and more.
Request Body JSON object containing the details of the user deletion request to insert or update.

Details on Query Parameters (optional keys):

  • Calculated Metric ID: ID for calculated metrics (not typically used here).
  • Entity: Level of data access report (property or account level).
  • Filter: Expression to filter results.
  • Names: Names of access bindings to retrieve.
  • Page Size: Maximum number of items to return.
  • Page Token: Token for paginated results.
  • Show Deleted: Whether to include soft-deleted properties.
  • Universal Analytics Property ID: UA property linked to GA4 property.
  • Update Mask: Fields to update (in snake case).

(Note: Most query parameters are generic and may not apply directly to user deletion but are available due to shared interface.)

Output

The node outputs an array of JSON objects representing the response from the Google Analytics API for the user deletion request upsert operation. The exact structure depends on the API response but generally includes confirmation of the inserted or updated user deletion request.

If binary data were involved, it would be summarized here, but this node deals only with JSON responses.

Dependencies

  • Requires an OAuth2 credential configured for Google Analytics API access.
  • The node uses the Google Analytics API endpoints:
    • Base URL for user deletion: https://www.googleapis.com/analytics/v3/userDeletion
  • Proper permissions/scopes must be granted to the OAuth2 credential to manage user deletion requests.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that a valid OAuth2 credential for Google Analytics is configured and selected.
  • Required Parameter Errors: The node validates required IDs such as Property ID before making requests. Missing these will cause errors like "Property ID is required."
  • API Errors: Errors returned from the Google Analytics API are wrapped and reported with messages starting "Error calling Google Analytics API." Check the error message and stack trace for details.
  • Invalid JSON in Request Body: Ensure the JSON provided in the Request Body field is valid and matches the expected schema for user deletion requests.

Links and References

This summary focuses on the User Deletion resource and the Insert or Update a User Deletion Request operation as requested.

Discussion