Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Data (V1Alpha) - Report Task → List Report Tasks

AI-generated

Overview

This node interacts with the Google Analytics API, specifically supporting a wide range of administrative and data-related operations across different versions (V1Alpha, V1Beta) and resource types. For the selected Resource "Data (V1Alpha) - Report Task" and Operation "List Report Tasks," it lists report tasks associated with a specified Google Analytics property.

Use cases include:

  • Retrieving a list of report tasks for a given property to monitor or manage scheduled reports.
  • Automating workflows that require fetching report task metadata from Google Analytics.
  • Integrating Google Analytics reporting task management into broader data pipelines.

Example: You want to fetch all report tasks created under a specific Google Analytics property to audit or trigger further processing based on those tasks.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property for which to list report tasks.
Query Parameters Optional parameters to filter or paginate the list of report tasks. Available options include:
- Calculated Metric ID Filter by a specific calculated metric ID.
- Entity Specify whether to request data at the property or account level.
- Filter Expression to filter results returned by the API.
- Names Names of access bindings to retrieve (not typically used for report tasks).
- Page Size Maximum number of report tasks to return (default 10).
- Page Token Token to fetch the next page of results for pagination.
- Show Deleted Whether to include soft-deleted ("trashed") properties in the results (default true).
- Universal Analytics Property ID UA property ID to look up the connected GA4 property (not directly related to report tasks).
- Update Mask List of fields to be updated (in snake case), not applicable for listing but available as parameter.

Output

The output is a JSON array where each element represents a report task object retrieved from the Google Analytics API. Each report task object contains metadata about a scheduled or completed report task within the specified property.

The exact structure of each report task object depends on the Google Analytics API response but generally includes identifiers, status, creation time, and other relevant details about the report task.

No binary data output is produced by this operation.

Dependencies

  • Requires an OAuth2 credential configured for Google Analytics API access.
  • The node uses the Google Analytics Data API endpoints (https://analyticsdata.googleapis.com/v1alpha) for the "Data (V1Alpha)" resources.
  • Proper permissions/scopes must be granted to the OAuth2 credential to access report tasks for the specified property.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure you have configured and selected valid OAuth2 credentials with appropriate scopes.
  • Required Parameter Errors: Errors like "Property ID is required" indicate that mandatory input parameters are missing. Provide the correct Property ID.
  • API Request Failures: Network issues, insufficient permissions, or invalid parameters can cause API errors. Check the error message for details and verify your credentials and inputs.
  • Pagination Issues: When retrieving large lists, use the Page Token and Page Size query parameters correctly to paginate through results.

Links and References

This summary focuses on the "Data (V1Alpha) - Report Task" resource and the "List Report Tasks" operation as requested.

Discussion