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