Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Alpha) - Property → Run Access Report

AI-generated

Overview

This node integrates 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 "Run Access Report" operation under the "Admin (V1Alpha) - Property" resource allows users to generate customized reports on data access records for a specified property.

Typical use cases include auditing who has accessed or modified Google Analytics properties, monitoring access bindings, and generating detailed access reports for compliance or security reviews. For example, an analytics administrator can run an access report to see which users have permissions on a particular property and what actions they performed.

Properties

Name Meaning
Query Parameters A collection of optional parameters to customize the access report request. Includes:
- Calculated Metric ID: ID for a calculated metric
- 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 report tasks to return (default 10)
- Page Token: Continuation token for pagination
- Show Deleted: 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 (snake case)
Request Body JSON object representing the request body payload for the API call. Used to specify detailed report parameters.

Output

The output is a JSON array containing the parsed response from the Google Analytics API for the access report run. This typically includes detailed data access records as returned by the API, such as user access details, timestamps, and affected resources.

No binary data output is produced by this operation.

Dependencies

  • Requires valid Google Analytics API OAuth2 credentials configured in n8n.
  • Uses the Google Analytics Admin API endpoint https://analyticsadmin.googleapis.com/v1alpha for the "Run Access Report" operation.
  • The node performs authenticated HTTP requests using OAuth2 tokens.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that OAuth2 credentials for Google Analytics are properly set up and linked in n8n.
  • Required Parameter Errors: The node validates required IDs such as Account ID or Property ID depending on the operation. Missing these will cause errors like "Account ID is required" or "Property ID is required." Provide all necessary identifiers.
  • API Call Failures: Errors from the Google Analytics API are wrapped and reported with messages like "Error calling Google Analytics API: [message]." Check the API quota, permissions, and validity of parameters.
  • Pagination Issues: When retrieving large reports, use the "Page Token" query parameter to paginate through results correctly.

Links and References

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

Discussion