REST Resource: properties.recurringAudienceLists

المورد: Recurring AudienceList

تؤدي قائمة المستخدمين المتكرّرة إلى إنشاء قوائم مستخدمين جديدة كل يوم. قوائم المستخدمين هم مستخدمون ضمن إحدى شرائح الجمهور في وقت إنشاء القائمة. تضمن قائمة المستخدمين المتكرّرة أن يكون لديك قائمة مستخدمين تستند إلى أحدث البيانات المتوفّرة للاستخدام كل يوم.

تمثيل JSON 
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "audienceLists": [
    string
  ],
  "activeDaysRemaining": integer,
  "webhookNotification": {
    object (WebhookNotification)
  }
}
الحقول
name

string

النتائج فقط. المُعرّف. اسم مورد قائمة المستخدمين المتكرّرة الذي تم تحديده أثناء الإنشاء. يحدّد اسم المورد هذا RecurringAudienceList.

تنسيق الملف: properties/{property}/recurringAudienceLists/{recurringAudienceList}
audience

string

مطلوب. اسم مورد الجمهور. يُحدِّد اسم المورد هذا الجمهور المُدرج والذي تتم مشاركته بين بيانات "إحصاءات Google" واجهات برمجة تطبيقات المشرف.

تنسيق الملف: properties/{property}/audiences/{audience}
audienceDisplayName

string

النتائج فقط. الاسم المعروض الوصفي لهذا الجمهور. على سبيل المثال، "المشترون".
dimensions[]

object (AudienceDimension)

مطلوب. السمات المطلوبة وعرضها في الردّ على قائمة المستخدمين
audienceLists[]

string

النتائج فقط. أسماء موارد قائمة المستخدمين لمثيلات قائمة المستخدمين التي تم إنشاؤها لقائمة المستخدمين المتكررة هذه. يتم إنشاء قائمة مستخدمين واحدة لكل يوم، وسيتم إدراج قائمة المستخدمين هنا.

يتم ترتيب هذه القائمة مع إدراج أحدث قائمة مستخدمين تم إنشاؤها أولاً.
activeDaysRemaining

integer

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

يتم تلقائيًا ضبط طلب قائمة المستخدمين المتكرّر لمواقع "إحصاءات 360" على 180 يومًا، ويكون الحد الأقصى له هو 365 يومًا. تبلغ مدة طلبات مواقع "إحصاءات Google" العادية 14 يومًا، وتبلغ مدتها 30 يومًا كحدّ أقصى.

أدنى قيمة مسموح بها أثناء الإنشاء هي 1. سيتم فرض الحد الأقصى للطلبات التي تتجاوز قيمتها الحد الأقصى الخاص بها.
webhookNotification

object (WebhookNotification)

اختياريّ. تضبط إشعارات الردّ التلقائي على الويب ليتم إرسالها من Google Analytics Data API إلى خادم الرد التلقائي على الويب. تجدر الإشارة إلى أنّ استخدام الردود التلقائية على الويب هو إجراء اختياري. وفي حال عدم استخدامها، عليك استطلاع واجهة برمجة التطبيقات هذه لمعرفة الوقت الذي تنشئ فيه قائمة مستخدمين متكرّرة قوائم مستخدمين جديدة. تسمح الردود التلقائية على الويب بإرسال إشعار إلى خوادمك لتجنب الحاجة إلى إجراء استطلاعات

سيتم إرسال طلبَي POST في كل مرة تنشئ فيها قائمة مستخدمين متكرّرة قائمة مستخدمين. يحدث ذلك مرة واحدة في اليوم إلى أن تصل قائمة المستخدمين المتكرّرة إلى 0 يوم نشط. سيتم إرسال الطلب الأول مع إظهار قائمة مستخدمين تم إنشاؤها حديثًا في حالتها CREATING. سيتم إرسال الطلب الثاني بعد اكتمال إنشاء قائمة المستخدمين (إما الحالة "نشط" أو "تعذّر الإجراء").

الطُرق

create

 ينشئ قائمة مستخدمين متكرّرة.

get

 الحصول على البيانات الوصفية للإعدادات حول قائمة مستخدمين متكرّرة معيّنة

list

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