Coba server MCP untuk Google Analytics. Instal dari
GitHub, dan lihat
pengumuman untuk mengetahui detail selengkapnya.
Method: properties.updateDataRetentionSettings
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Memperbarui setelan retensi data singleton untuk properti ini.
Permintaan HTTP
PATCH https://analyticsadmin.googleapis.com/v1beta/{dataRetentionSettings.name=properties/*/dataRetentionSettings}
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter |
dataRetentionSettings.name |
string
Hanya output. Nama resource untuk resource DataRetentionSetting ini. Format: properties/{property}/dataRetentionSettings
|
Parameter kueri
Parameter |
updateMask |
string (FieldMask format)
Wajib. Daftar kolom yang akan diperbarui. Nama kolom harus menggunakan format snake case (misalnya, "field_to_update"). Kolom yang dihapus tidak akan diperbarui. Untuk mengganti seluruh entity, gunakan satu jalur dengan string "*" untuk mencocokkan semua kolom. Ini adalah daftar yang dipisahkan koma yang berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo" .
|
Isi permintaan
Isi permintaan memuat instance DataRetentionSettings
.
Isi respons
Jika berhasil, isi respons akan berisi instance DataRetentionSettings
.
Cakupan otorisasi
Memerlukan cakupan OAuth berikut ini:
https://www.googleapis.com/auth/analytics.edit
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[null,null,["Terakhir diperbarui pada 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`"]]