REST Resource: properties.recurringAudienceLists

المرجع: RecurringAudienceList

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

تمثيل 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

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

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

string

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

object (AudienceDimension)

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

string

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

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

integer

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

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

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

object (WebhookNotification)

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

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

الطُرق

create

 تنشئ قائمة جمهور متكررة.

get

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

list

 تعرض هذه السمة جميع قوائم الجمهور المتكرّرة لموقع معيّن.