Method: properties.list

عرض المواقع الفرعية ضمن الحساب الرئيسي المحدّد.

سيتم عرض مواقع "إحصاءات Google" 4 فقط. سيتم استبعاد الخصائص إذا لم يكن لدى المتصل إمكانية الوصول. ويتم استبعاد المواقع الإلكترونية التي تم حذفها جزئيًا (أي "المهملات") تلقائيًا. عرض قائمة فارغة في حال عدم العثور على خصائص ذات صلة.

طلب HTTP

GET https://analyticsadmin.googleapis.com/v1beta/properties

يستخدم عنوان URL بنية gRPC Transcode.

معلمات طلب البحث

المَعلمات
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

ما إذا كان سيتم تضمين الخصائص التي تم حذفها جزئيًا (أي: "المهملات") في النتائج. يمكن فحص المواقع لتحديد ما إذا تم حذفها أم لا.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

رسالة استجابة لخاصية RPC.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل 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