Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Beta) - Account → Search Change History Events

AI-generated

Overview

This node integrates with the Google Analytics API, specifically targeting the Admin (V1Beta) - Account resource to perform operations related to account management and data retrieval. The "Search Change History Events" operation allows users to search through all changes made to a Google Analytics account or its child entities by applying specified filters.

Common scenarios where this node is beneficial include auditing account modifications, tracking configuration changes over time, and monitoring administrative activities within Google Analytics accounts. For example, an analytics administrator can use this node to retrieve a history of changes to user permissions or property settings to ensure compliance and troubleshoot issues.

Properties

Name Meaning
Account ID The unique identifier of the Google Analytics account for which the change history events are searched.
Query Parameters Optional parameters to filter and control the search results, including:
- Calculated Metric ID: Filter by specific calculated metric ID.
- Entity: Specify whether to request data at the property or account level.
- Filter: Expression to filter the results based on criteria.
- 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 (used for pagination).
- Show Deleted: Boolean indicating whether to include soft-deleted ("trashed") properties in results.
- Universal Analytics Property ID: UA property to look up connected GA4 property.
- Update Mask: List of fields to be updated (in snake case).
Request Body JSON object containing additional request details or filters as required by the API for the operation.

Output

The output is a JSON array where each element corresponds to a response item from the Google Analytics API for the requested operation. Specifically for the "Search Change History Events" operation, the JSON output contains the list of change history events matching the query parameters provided.

The structure typically includes details about each change event such as the type of change, affected resources, timestamps, and user information who made the changes.

No binary data output is produced 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 endpoints.
  • Proper permissions must be granted to the OAuth2 credential to access account change history data.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing credentials, ensure that a valid Google Analytics OAuth2 API credential is configured and selected.
  • Account ID Required: Many operations require the Account ID; if omitted, the node will throw an error. Always provide the correct Account ID when performing account-specific operations.
  • Invalid Query Parameters: Incorrect or malformed filter expressions in query parameters may cause API errors. Validate filter syntax according to Google Analytics API documentation.
  • API Rate Limits: Excessive requests may lead to rate limiting by Google Analytics API. Implement retries or backoff strategies if needed.
  • Error Messages: Errors returned from the API are wrapped with descriptive messages. Review the message and stack trace for debugging.

Links and References

Discussion