يسرد جميع قوائم المستخدمين لأحد المواقع. يمكن استخدام هذه الطريقة للعثور على قوائم المستخدمين الحالية وإعادة استخدامها بدلاً من إنشاء قوائم مستخدمين جديدة غير ضرورية. يمكن أن يتضمّن شريحة الجمهور نفسها قوائم مستخدمين متعدّدة تمثّل قائمة المستخدِمين الذين كانوا مُدرَجين في شريحة جمهور في أيام مختلفة.
اطّلع على إنشاء قائمة مستخدمين للحصول على مقدمة عن قوائم المستخدمين مع أمثلة.
تتوفّر هذه الطريقة عند تثبيت الإصدار التجريبي من خلال الرابط audienceExports.list. لإرسال ملاحظاتك حول واجهة برمجة التطبيقات هذه، يُرجى ملء نموذج ملاحظات وآراء بشأن Audience Export API في "إحصاءات Google".
طلب HTTP
GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
parent |
مطلوب. سيتم إدراج جميع قوائم المستخدمين لهذا الموقع في الردّ. تنسيق الملف: |
معامِلات طلب البحث
المعلمات | |
---|---|
pageSize |
اختياريّ. الحد الأقصى لعدد قوائم المستخدمين المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. وفي حال عدم تحديده، سيتم عرض 200 قائمة مستخدمين كحدّ أقصى. القيمة القصوى هي 1000 (سيتم فرض القيم الأعلى على الحد الأقصى). |
pageToken |
اختياريّ. رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق " عند التقسيم على صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
قائمة بجميع قوائم المستخدمين لأحد المواقع.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"audienceLists": [
{
object ( |
الحقول | |
---|---|
audienceLists[] |
كل قائمة مستخدمين لأحد المواقع. |
nextPageToken |
رمز مميز يمكن إرساله على شكل |
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics