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