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

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

نص الطلب

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

نص الاستجابة

رسالة الرد على طلب إجراء عن بُعد (RPC) خاص بـ 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