Method: properties.audiences.list

يسرد شرائح الجمهور في أحد المواقع. قد لا تكون شرائح الجمهور التي تم إنشاؤها قبل العام 2020 متاحة. لن تعرض شرائح الجمهور التلقائية تعريفات الفلاتر.

طلب HTTP

GET https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/audiences

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
parent

string

مطلوب. مثال على تنسيق المعرّف: الخصائص/1234

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

المعلمات
pageSize

integer

الحد الأقصى لعدد الموارد المطلوب عرضها. في حال عدم تحديد ذلك، سيتم عرض 50 موردًا كحدّ أقصى. الحد الأقصى للقيمة هو 200 (سيتم فرض القيم الأعلى على الحد الأقصى).
pageToken

string

رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق "audiences.list". يمكنك توفير هذا الحقل لاسترداد الصفحة التالية.

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

نص الطلب

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

نص الاستجابة

رسالة رد لـ Audience.list RPC.

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

تمثيل JSON 
{
  "audiences": [
    {
      object (Audience)
    }
  ],
  "nextPageToken": string
}
الحقول
audiences[]

object (Audience)

قائمة شرائح الجمهور
nextPageToken

string

رمز مميز يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية. في حال إسقاط هذا الحقل، لن تظهر أي صفحات لاحقة.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit