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