Method: properties.customDimensions.list
يُدرج هذا العمود السمات المخصّصة في موقع معيّن.
طلب HTTP
GET https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/customDimensions
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
parent |
string
مطلوب. مثال على التنسيق: properties/1234
|
مَعلمات طلب البحث
المعلمات |
pageSize |
integer
الحد الأقصى لعدد الموارد التي سيتم عرضها إذا لم يتم تحديد عدد، سيتم عرض 50 موردًا بحد أقصى. الحد الأقصى للقيمة هو 200 (سيتم تحويل القيم الأعلى إلى الحد الأقصى).
|
pageToken |
string
رمز مميّز للصفحة، تم تلقّيه من مكالمة customDimensions.list سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة. عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى customDimensions.list مع الطلب الذي قدّم الرمز المميّز للصفحة.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة الردّ على طلب إجراء RPC في customDimensions.list
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
{
"customDimensions": [
{
object (CustomDimension )
}
],
"nextPageToken": string
} |
الحقول |
customDimensions[] |
object (CustomDimension )
قائمة السمات المخصّصة
|
nextPageToken |
string
رمز مميّز يمكن إرساله كـ pageToken لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.
|
نطاقات التفويض
يتطلب أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics.edit
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-01-14 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-01-14 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Lists all CustomDimensions on a specified Google Analytics 4 property."],["Allows filtering by page size and utilizes pagination for retrieving large datasets."],["Requires specific authorization scopes for data access."],["Provides details on the HTTP request structure, including path and query parameters."],["Returns a list of CustomDimensions and a token for accessing subsequent pages if available."]]],["This document details how to list custom dimensions associated with a Google Analytics property. The core action is sending a `GET` request to `https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/customDimensions`. The `parent` path parameter, representing the property ID, is required. Optional query parameters `pageSize` (up to 200) and `pageToken` are available for pagination. The request body must be empty. The response contains a list of `customDimensions` and a `nextPageToken` for further pagination. Access requires either `analytics.readonly` or `analytics.edit` authorization scopes.\n"]]