Method: properties.list

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

لن يتم عرض سوى &"GA4"المواقع. سيتم استبعاد المواقع إذا لم يمكن للمتصل الوصول إليها. يتم استبعاد المواقع الإلكترونية المحذوفة نهائيًا (أي: "trashed") تلقائيًا. عرض قائمة فارغة إذا لم يتم العثور على خصائص ذات صلة.

طلب HTTP

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

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

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

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

تم تلقّي رمز مميّز للصفحة من مكالمة سابقة على ListProperties. قدِّم هذا الإجراء لاسترداد الصفحة التالية. عند التقسيم على صفحات، يجب أن تتطابق كل المعلَمات الأخرى المقدّمة إلى ListProperties مع المكالمة التي قدّمت الرمز المميّز للصفحة.

showDeleted

boolean

ما إذا كان مطلوبًا تضمين خصائص "تم الحذف{1/}" (أي: "trashed"quot) في النتائج. يمكن فحص المواقع لتحديد ما إذا تم حذفها أم لا.

نص الطلب

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

نص الاستجابة

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

رسالة الاستجابة لاستدعاء الإجراء عن بُعد ListProperties.

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