Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions84

Overview

This node integrates with the Google Analytics API, specifically targeting the Admin (V1Alpha) Account resource for the "Delete Account" operation. It allows users to mark a specified Google Analytics account as soft-deleted (trashed). This is useful in scenarios where an account needs to be deactivated or removed without permanently deleting it immediately, enabling potential recovery or auditing.

Practical examples include:

  • Automating the cleanup of unused or obsolete Google Analytics accounts.
  • Managing account lifecycle within an organization by programmatically marking accounts as deleted.
  • Integrating account deletion workflows into broader data governance or compliance processes.

Properties

Name Meaning
Account ID The unique identifier of the Google Analytics account to delete.
Query Parameters Optional parameters to customize the request; includes options like filtering, pagination, etc.

The "Query Parameters" collection supports these options (not all relevant for delete but available generally):

  • Calculated Metric ID
  • Entity (property or account level)
  • Filter expression
  • Names (access bindings)
  • Page Size (max number of results)
  • Page Token (pagination continuation token)
  • Show Deleted (include soft-deleted properties)
  • Universal Analytics Property ID
  • Update Mask (fields to update)

Output

The output is a JSON array containing the response from the Google Analytics API after attempting to delete the specified account. The response typically includes the representation of the account marked as soft-deleted.

No binary data output is involved.

Example output structure (simplified):

[
  {
    "name": "accounts/123456",
    "deleted": true,
    "displayName": "Example Account",
    ...
  }
]

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 permissions on the Google Analytics account are necessary to perform deletion.

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 connected.
  • Account ID Required: The node requires the Account ID property to be set; missing this will cause an error.
  • API Errors: Errors returned from the Google Analytics API (e.g., permission denied, invalid account ID) will be surfaced with messages prefixed by "Error calling Google Analytics API". Check the account ID validity and user permissions.
  • Soft Delete Behavior: The deletion marks the account as soft-deleted; it is not permanently removed immediately. Users should be aware of this behavior when automating workflows.

Links and References

Discussion