REST Resource: properties.recurringAudienceLists

{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "audienceLists": [
    string
  ],
  "activeDaysRemaining": integer,
  "webhookNotification": {
    object (WebhookNotification)
  }
}

string

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

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

string

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

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

string

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

object (AudienceDimension)

مطلوبة. السمات المطلوبة وعرضها في استجابة قائمة المستخدمين.

string

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

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

integer

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

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

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

object (WebhookNotification)

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

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