Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Beta) - Property → Run Access Report

AI-generated

Overview

This node integrates with the Google Analytics API, specifically supporting the "Admin (V1Beta) - Property" resource and the "Run Access Report" operation. It allows users to run customized access reports on a specified Google Analytics property. This is useful for auditing and monitoring data access permissions and activities within a Google Analytics property.

Typical use cases include:

  • Generating reports to review who has access to a property and what level of access they have.
  • Auditing access changes over time for compliance or security purposes.
  • Integrating access report data into workflows for automated alerts or further processing.

For example, a marketing team might use this node to regularly check which users have access to their GA4 properties and ensure that only authorized personnel can view sensitive analytics data.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property for which the access report will be run.
Query Parameters Optional parameters to customize the access report request. These include:
- Calculated Metric ID: ID for a calculated metric to include.
- Entity: Level at which to request the report (property or account).
- Filter: Expression to filter the results.
- Names: Specific names of access bindings to retrieve.
- Page Size: Maximum number of report tasks to return (default 10).
- Page Token: Token for fetching the next page of results.
- Show Deleted: Whether to include soft-deleted ("trashed") properties in results (boolean).
- Universal Analytics Property ID: UA property to look up connected GA4 property.
- Update Mask: List of fields to update (in snake case).
Request Body JSON object representing the body of the request sent to the API.

Output

The output is a JSON array containing the parsed response from the Google Analytics API's access report endpoint. The structure corresponds directly to the API's response for an access report, typically including details about access records such as user permissions, roles, and related metadata.

No binary data output is involved.

Dependencies

  • Requires an OAuth2 credential configured for Google Analytics API access.
  • The node uses the googleAnalyticsOAuth2Api credential to authenticate requests.
  • The base URLs used depend on the resource version but for this operation it targets the Google Analytics Admin API v1beta endpoint.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that you have configured and selected valid OAuth2 credentials for Google Analytics.
  • Required Parameter Errors: The node validates required parameters like Property ID and will throw errors if these are missing. Make sure to provide all mandatory IDs.
  • API Request Failures: Errors returned by the Google Analytics API will be wrapped and shown with the message prefix "Error calling Google Analytics API." Check the error message and stack trace for details.
  • Pagination Issues: When using pagination parameters (pageSize, pageToken), ensure tokens are correctly handled to fetch subsequent pages.

Links and References

This summary is based solely on static analysis of the provided source code and property definitions.

Discussion