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

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

نص الطلب

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

نص الاستجابة

رسالة استجابة لـ Property.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