يسرد جميع قوائم المستخدمين لأحد المواقع. يمكن استخدام هذه الطريقة للعثور على قوائم المستخدمين الحالية وإعادة استخدامها بدلاً من إنشاء قوائم مستخدمين جديدة غير ضرورية. يمكن أن يكون للجمهور نفسه قوائم مستخدمين متعددة تمثل قائمة المستخدمين الذين كانوا ضمن شريحة جمهور معيّنة في أيام مختلفة.
راجِع إنشاء قائمة مستخدمين للحصول على مقدمة عن قوائم المستخدمين مع أمثلة.
تتوفّر هذه الطريقة في الإصدار التجريبي الثابت على الرابط 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