جرِّب خادم MCP لخدمة "إحصاءات Google". يمكنك تثبيت التطبيق من
GitHub والاطّلاع على
الإعلان لمعرفة المزيد من التفاصيل.
Method: properties.getDataRetentionSettings
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض إعدادات الاحتفاظ ببيانات سينغلتون لهذا الموقع.
طلب HTTP
GET https://analyticsadmin.googleapis.com/v1beta/{name=properties/*/dataRetentionSettings}
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
| المَعلمات |
name |
string
مطلوبة. اسم الإعدادات المطلوب البحث عنها. التنسيق: المواقع/{property}/dataالاحتفاظSettings مثال: "properties/1000/data DisplaySettings"
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال DataRetentionSettings.
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analytics.edit
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieve data retention settings for a specific Google Analytics 4 property using an HTTP GET request.\u003c/p\u003e\n"],["\u003cp\u003eThe request URL requires a property ID and utilizes gRPC Transcoding syntax.\u003c/p\u003e\n"],["\u003cp\u003eAn empty request body is necessary, while a successful response returns a DataRetentionSettings object.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires specific OAuth scopes for either read-only or edit access to Analytics data.\u003c/p\u003e\n"]]],["This document details retrieving data retention settings for a property using a `GET` request. The core action is to `GET` data from the specified URL, `https://analyticsadmin.googleapis.com/v1beta/{name=properties/*/dataRetentionSettings}`, using gRPC Transcoding syntax. The `name` path parameter, formatted as \"properties/{property}/dataRetentionSettings\", is required. The request body must be empty. A successful response will include an instance of `DataRetentionSettings`. Authorization requires either `analytics.readonly` or `analytics.edit` OAuth scopes.\n"],null,["# Method: properties.getDataRetentionSettings\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns the singleton data retention settings for this property.\n\n### HTTP request\n\n`GET https://analyticsadmin.googleapis.com/v1beta/{name=properties/*/dataRetentionSettings}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The name of the settings to lookup. Format: properties/{property}/dataRetentionSettings Example: \"properties/1000/dataRetentionSettings\" |\n\n### Request body\n\nThe request body must be empty.\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 one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/analytics.readonly`\n- `https://www.googleapis.com/auth/analytics.edit`"]]
