Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Beta) - Property → Update Property Data Retention Settings

AI-generated

Overview

This node integrates with the Google Analytics API, specifically targeting the Admin (V1Beta) resource for managing properties. The "Update Property Data Retention Settings" operation allows users to update data retention settings for a specified Google Analytics property. This is useful for organizations that need to control how long user and event data is retained within their analytics properties to comply with privacy regulations or internal policies.

Typical use cases include:

  • Adjusting data retention periods to meet GDPR or CCPA compliance.
  • Automating updates to data retention settings across multiple properties.
  • Integrating data retention management into broader analytics workflows.

Properties

Name Meaning
Property ID The unique identifier of the Google Analytics property whose data retention settings will be updated.
Query Parameters Optional parameters to customize the request, including:
- 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: Maximum number of report tasks to return.
- Page Token: Token for fetching next page of results.
- Show Deleted: Whether to include soft-deleted properties.
- 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 containing the new data retention settings to apply to the property.

Output

The node outputs a JSON array where each element corresponds to the response from the Google Analytics API for the update request. The structure of the output JSON matches the API's response schema for property data retention settings, typically including details such as retention duration, reset conditions, and other related metadata.

No binary data output is involved in this operation.

Dependencies

  • Requires an OAuth2 credential configured for Google Analytics API access.
  • The node uses the Google Analytics Admin API endpoint https://analyticsadmin.googleapis.com/v1beta.
  • Proper permissions on the Google Analytics property are necessary to update data retention settings.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing credentials, ensure that a valid Google Analytics OAuth2 credential is configured in n8n.
  • Required Parameter Errors: The node requires the Property ID to be set; if omitted, it will throw an error indicating the missing parameter.
  • API Permission Errors: Insufficient permissions on the Google Analytics property may cause API errors; verify that the authenticated user has the necessary admin rights.
  • Invalid Request Body: Ensure the JSON in the Request Body is correctly formatted and includes valid fields according to the Google Analytics API specification.
  • Network or API Errors: General API call failures will include error messages; check network connectivity and Google API status.

Links and References

Discussion