Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Beta) - Account → Run Access Report

AI-generated

Overview

This node interacts with the Google Analytics API, specifically supporting a wide range of administrative and data operations. The "Run Access Report" operation under the "Admin (V1Beta) - Account" resource allows users to run customized reports on data access records for a specified Google Analytics account.

This operation is useful for auditing and monitoring who has accessed or modified data within an account, helping ensure compliance and security. For example, an organization can use this to generate reports showing which users accessed sensitive analytics data over a given period.

Properties

Name Meaning
Account ID The unique identifier of the Google Analytics account for which the access report will be run.
Query Parameters Optional parameters to customize the access report request. Includes:
- Calculated Metric ID: ID for a calculated metric to include.
- 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: Token for fetching next page of results.
- Show Deleted: Whether to include soft-deleted ("trashed") properties in results (default true).
- Universal Analytics Property ID: UA property to look up connected GA4 property.
- Update Mask: List of fields to update (snake case field names).
Request Body JSON object representing the request body for the access report run. This contains detailed report specifications such as dimensions, metrics, date ranges, filters, etc.

Output

The output is a JSON array containing the response from the Google Analytics API for the access report run. The structure corresponds directly to the API's response format for access reports, typically including:

  • Metadata about the report.
  • Rows of data representing access records.
  • Pagination tokens if applicable.

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/v1beta.
  • The node requires network access to Google's APIs.

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 selected.
  • Required Parameter Errors: Errors like "Account ID is required" indicate missing mandatory input parameters. Verify that the Account ID is provided when running the access report.
  • 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 error details for issues such as permission problems, invalid parameters, or quota limits.
  • Pagination Handling: If the report returns many results, use the Page Token query parameter to paginate through results.

Links and References

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

Discussion