Method: properties.updateDataRetentionSettings

  • This page provides details on how to update the data retention settings for a property using a PATCH request.

  • The request uses gRPC Transcoding syntax and requires the dataRetentionSettings.name path parameter to identify the property.

  • An updateMask query parameter is required to specify which fields of the data retention settings will be updated.

  • The request and response bodies both contain an instance of DataRetentionSettings.

  • Updating data retention settings requires the https://www.googleapis.com/auth/analytics.edit authorization scope.

Updates the singleton data retention settings for this property.

HTTP request

PATCH https://analyticsadmin.googleapis.com/v1beta/{dataRetentionSettings.name=properties/*/dataRetentionSettings}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
dataRetentionSettings.name

string

Output only. Resource name for this DataRetentionSetting resource. Format: properties/{property}/dataRetentionSettings

Query parameters

Parameters
updateMask

string (FieldMask format)

Required. The list of fields to be updated. Field names must be in snake case (e.g., "field_to_update"). Omitted fields will not be updated. To replace the entire entity, use one path with the string "*" to match all fields.

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".

Request body

The request body contains an instance of DataRetentionSettings.

Response body

If successful, the response body contains an instance of DataRetentionSettings.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/analytics.edit