Method: properties.recurringAudienceLists.list

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

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

طلب HTTP

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

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

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

المَعلمات
parent

string

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

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

المَعلمات
pageSize

integer

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

string

اختياريّ. رمز مميز للصفحة تم استلامه من مكالمة سابقة مع "recurringAudienceLists.list". يُرجى توفير هذا الحقل لاسترداد الصفحة التالية.

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

نص الطلب

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

نص الاستجابة

قائمة بجميع قوائم المستخدمين المتكرّرة لأحد المواقع.

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

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

object (RecurringAudienceList)

كل قائمة جمهور متكرّرة لأحد المواقع.
nextPageToken

string

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

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

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

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