Method: properties.audienceLists.list

يعرض جميع قوائم المستخدمين لموقع معيّن. يمكن استخدام هذه الطريقة للعثور على قوائم المستخدمين الحالية وإعادة استخدامها بدلاً من إنشاء قوائم مستخدمين جديدة غير ضرورية. يمكن أن تتضمّن شريحة الجمهور نفسها قوائم جمهور متعددة تمثّل قائمة المستخدمين الذين كانوا في شريحة جمهور في أيام مختلفة.

اطّلِع على إنشاء قائمة مستخدمين للحصول على مقدّمة عن قوائم المستخدمين مع أمثلة.

تتوفّر هذه الطريقة في الإصدار التجريبي المستقر في audienceExports.list. لتقديم ملاحظاتك وآرائك حول واجهة برمجة التطبيقات هذه، يُرجى ملء نموذج ملاحظات وآراء عن Audience Export API في "إحصاءات Google".

طلب HTTP

GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists

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

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

المعلمات
parent

string

مطلوب. سيتم إدراج جميع قوائم المستخدمين لهذا الموقع في الردّ. التنسيق: properties/{property}

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

المعلمات
pageSize

integer

اختيارية: الحدّ الأقصى لعدد قوائم الجمهور المطلوب عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 200 قائمة جمهور كحد أقصى. الحد الأقصى للقيمة هو 1000 (سيتم تحويل القيم الأعلى إلى الحد الأقصى).
pageToken

string

اختيارية: رمز مميّز للصفحة، تم تلقّيه من مكالمة audienceLists.list سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة.

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

نص الطلب

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

نص الاستجابة

قائمة بجميع قوائم المستخدمين لموقع معيّن

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

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

object (AudienceList)

كل قائمة جمهور لموقع.
nextPageToken

string

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

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

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