Essayez le serveur MCP pour Google Analytics. Installez-le depuis
GitHub et consultez l'
annonce pour en savoir plus.
Method: properties.updateDataRetentionSettings
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Met à jour les paramètres de conservation des données du singleton pour cette propriété.
Requête HTTP
PATCH https://analyticsadmin.googleapis.com/v1beta/{dataRetentionSettings.name=properties/*/dataRetentionSettings}
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
dataRetentionSettings.name |
string
Uniquement en sortie. Nom de la ressource DataConservationSetting. Format: Properties/{property}/dataConservationSettings
|
Paramètres de requête
| Paramètres |
updateMask |
string (FieldMask format)
Obligatoire. Liste des champs à mettre à jour. Les noms de champs doivent être en snake case (par exemple, "champ_à_mettre à jour"). Les champs omis ne seront pas mis à jour. Pour remplacer l'ensemble de l'entité, utilisez un chemin d'accès contenant la chaîne "*" pour faire correspondre tous les champs. Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo"
|
Corps de la requête
Le corps de la requête contient une instance DataRetentionSettings.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de DataRetentionSettings.
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/analytics.edit
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eThis method updates the data retention settings for a Google Analytics 4 property using an HTTP PATCH request.\u003c/p\u003e\n"],["\u003cp\u003eIt requires specifying the property in the path parameter and uses a field mask in the query parameter to indicate which fields should be updated.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain the desired DataRetentionSettings, and a successful response will return the updated settings.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/analytics.edit\u003c/code\u003e scope is necessary to use this method.\u003c/p\u003e\n"]]],["This document details updating data retention settings for a property using a `PATCH` request to a specified URL. The URL includes a path parameter, `dataRetentionSettings.name`, indicating the resource to be updated. The `updateMask` query parameter specifies which fields to modify. The request and response bodies use the `DataRetentionSettings` format. The process requires authorization via the `https://www.googleapis.com/auth/analytics.edit` OAuth scope. It also supports the `Try it!` function.\n"],null,["# Method: properties.updateDataRetentionSettings\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates the singleton data retention settings for this property.\n\n### HTTP request\n\n`PATCH https://analyticsadmin.googleapis.com/v1beta/{dataRetentionSettings.name=properties/*/dataRetentionSettings}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------------------------|---------------------------------------------------------------------------------------------------------------------------------|\n| `dataRetentionSettings.name` | `string` Output only. Resource name for this DataRetentionSetting resource. Format: properties/{property}/dataRetentionSettings |\n\n### Query parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` 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\"`. |\n\n### Request body\n\nThe request body contains an instance of [DataRetentionSettings](/analytics/devguides/config/admin/v1/rest/v1beta/DataRetentionSettings).\n\n### Response body\n\nIf successful, the response body contains an instance of [DataRetentionSettings](/analytics/devguides/config/admin/v1/rest/v1beta/DataRetentionSettings).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/analytics.edit`"]]
