Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Alpha) - Property → Acknowledge User Data Collection

AI-generated

Overview

This node interacts with the Google Analytics API, specifically supporting a wide range of administrative and data management operations across different versions (v1alpha, v1beta) and data types. The "Acknowledge User Data Collection" operation under the "Admin (V1Alpha) - Property" resource allows users to acknowledge the terms of user data collection for a specified Google Analytics property.

This is useful in scenarios where compliance with user data policies is required before enabling or continuing data collection on a property. For example, an organization may need to programmatically confirm that they have acknowledged Google's user data collection terms as part of their setup or audit process.

Properties

Name Meaning
Property ID The unique identifier of the Google Analytics property for which to acknowledge user data collection.
Query Parameters Optional parameters to customize the request, including filters, pagination, and other specific options.
Request Body JSON object containing any additional data required by the API endpoint (not typically needed for this operation).

Details on Query Parameters (optional)

  • Calculated Metric ID: ID for calculated metrics.
  • Entity: Level of data access report (property or account).
  • Filter: Expression to filter results.
  • Names: Names of access bindings to retrieve.
  • Page Size: Max number of report tasks to return.
  • Page Token: Token for fetching next page.
  • Show Deleted: Include soft-deleted properties.
  • Universal Analytics Property ID: UA property to look up connected GA4 property.
  • Update Mask: Fields to update (snake case).

(Note: These query parameters are generic and available for multiple operations; for this specific operation, they might not be applicable.)

Output

The output is a JSON array containing the parsed response from the Google Analytics API call. For the "Acknowledge User Data Collection" operation, the response typically confirms the acknowledgment status or returns the updated property information.

No binary data output is involved in this operation.

Dependencies

  • Requires an OAuth2 API credential for Google Analytics API authentication.
  • The node uses the base URL https://analyticsadmin.googleapis.com/v1alpha for this operation.
  • Proper permissions on the Google Analytics property are necessary to perform the acknowledgment.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that valid OAuth2 credentials are configured in n8n for Google Analytics.
  • Required Parameter Missing: Errors like "Property ID is required" indicate that the Property ID input was not provided. Make sure to specify the correct Property ID.
  • API Call Failures: Errors returned from the Google Analytics API will be wrapped with messages like "Error calling Google Analytics API." Check the error message and stack trace for details. Common issues include insufficient permissions or invalid property IDs.
  • Invalid Query Parameters: Providing unsupported or malformed query parameters may cause API errors. Use only supported parameters relevant to the operation.

Links and References

This summary focuses on the "Admin (V1Alpha) - Property" resource and the "Acknowledge User Data Collection" operation as requested.

Discussion