Method: properties.list

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

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

طلب 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 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