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