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