Method: properties.list
تعرِض هذه الدالة المواقع الفرعية ضمن الحساب الرئيسي المحدّد.
سيتم استبعاد المواقع إذا لم يكن لدى المتصل إذن الوصول إليها. يتم تلقائيًا استبعاد المواقع التي تم حذفها مؤقتًا (أي "المُرسَلة إلى المهملات"). تعرِض هذه الدالة قائمة فارغة في حال عدم العثور على أيّ مواقع ذات صلة.
طلب HTTP
GET https://analyticsadmin.googleapis.com/v1beta/properties
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات طلب البحث
المعلمات |
filter |
string
مطلوب. تعبير لفلترة نتائج الطلب الحقول المؤهَّلة للفلترة هي: parent: (اسم المورد للحساب/الموقع الرئيسي) أو ancestor: (اسم المورد للحساب الرئيسي) أو firebase_project: (رقم أو معرّف مشروع Firebase المرتبط). في ما يلي بعض الأمثلة على الفلاتر:
| Filter | Description |
|-----------------------------|-------------------------------------------|
| parent:accounts/123 | The account with account id: 123. |
| parent:properties/123 | The property with property id: 123. |
| ancestor:accounts/123 | The account with account id: 123. |
| firebase_project:project-id | The firebase project with id: project-id. |
| firebase_project:123 | The firebase project with number: 123. |
|
pageSize |
integer
الحد الأقصى لعدد الموارد التي سيتم عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة، حتى إذا كانت هناك صفحات إضافية. إذا لم يتم تحديد عدد، سيتم عرض 50 موردًا بحد أقصى. الحد الأقصى للقيمة هو 200 (سيتم تحويل القيم الأعلى إلى الحد الأقصى)
|
pageToken |
string
رمز مميّز للصفحة، تم تلقّيه من مكالمة properties.list سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة. عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى properties.list مع الطلب الذي قدّم الرمز المميّز للصفحة.
|
showDeleted |
boolean
ما إذا كان سيتم تضمين المواقع التي تم حذفها مؤقتًا (أي "المُرسَلة إلى المهملات") في النتائج. يمكن فحص المواقع لتحديد ما إذا تم حذفها أم لا.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة الاستجابة لاستدعاء إجراء properties.list عن بُعد
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
{
"properties": [
{
object (Property )
}
],
"nextPageToken": string
} |
الحقول |
properties[] |
object (Property )
النتائج التي تطابقت مع معايير الفلترة وكان بإمكان المتصل الوصول إليها
|
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 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Returns a list of \"GA4\" properties under a specified parent Account, excluding those without user access and soft-deleted ones."],["Allows filtering results by parent, ancestor, or linked Firebase project using the `filter` query parameter."],["Supports pagination with `pageSize` and `pageToken` parameters to retrieve large result sets."],["Requires `analytics.readonly` or `analytics.edit` authorization scopes for access."],["Provides a JSON response containing an array of properties and a token for retrieving subsequent pages."]]],["This document details how to retrieve a list of child properties under a specified parent account using a `GET` request to the provided URL. Key actions involve using query parameters such as `filter`, `pageSize`, `pageToken`, and `showDeleted` to refine the search. The `filter` parameter allows specification of parent account/property, ancestor, or firebase project. The response body, in JSON format, returns a list of accessible properties and a `nextPageToken` for pagination. The process requires specific authorization scopes.\n"]]