FrequencyCap

إعدادات تتحكّم في عدد المرات التي قد يظهر فيها الإعلان نفسه للمستخدم خلال فترة زمنية معيّنة

تمثيل JSON 
{
  "unlimited": boolean,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer,
  "maxImpressions": integer
}
الحقول
unlimited

boolean

ما إذا كان سيتم تطبيق تحديد عدد مرات الظهور غير المحدود عند ضبط هذا الحقل على true، لن تسري حقول تحديد عدد مرات الظهور المتبقية.
timeUnit

enum (TimeUnit)

الوحدة الزمنية التي سيتم فيها تطبيق تحديد عدد مرات الظهور.

مطلوبة عندما تكون قيمة unlimited هي false.
timeUnitCount

integer

عدد timeUnit الذي سيستمر تحديد عدد مرات الظهور.

مطلوبة عندما تكون قيمة unlimited هي false. يتم تطبيق القيود التالية استنادًا إلى قيمة timeUnit:

  • TIME_UNIT_LIFETIME - هذا الحقل ناتج فقط وسيتم ضبطه تلقائيًا على 1
  • TIME_UNIT_MONTHS - يجب أن تتراوح القيمة بين 1 و2.
  • TIME_UNIT_WEEKS - يجب أن تتراوح القيمة بين 1 و4.
  • TIME_UNIT_DAYS - يجب أن تتراوح القيمة بين 1 و6.
  • TIME_UNIT_HOURS - يجب أن تتراوح القيمة بين 1 و23.
  • TIME_UNIT_MINUTES - يجب أن تتراوح القيمة بين 1 و59.
maxImpressions

integer

الحد الأقصى لعدد المرّات التي يمكن أن يتم فيها عرض الإعلان نفسه للمستخدم خلال هذه الفترة. يجب أن تكون القيمة أكبر من 0.

مطلوبة عندما تكون قيمة unlimited هي false.

TimeUnit

الوحدات الزمنية المحتملة.

عمليات التعداد
TIME_UNIT_UNSPECIFIED قيمة الوحدة الزمنية غير محدّدة أو غير معروفة في هذا الإصدار.
TIME_UNIT_LIFETIME سيتم تطبيق تحديد عدد مرات الظهور على عمر العنصر بالكامل.
TIME_UNIT_MONTHS سيتم تطبيق تحديد عدد مرات الظهور على عدد من الأشهر.
TIME_UNIT_WEEKS سيتم تطبيق تحديد عدد مرات الظهور على عدد من الأسابيع.
TIME_UNIT_DAYS سيتم تطبيق تحديد عدد مرات الظهور على عدد من الأيام.
TIME_UNIT_HOURS سيتم تطبيق تحديد عدد مرات الظهور على عدد من الساعات.
TIME_UNIT_MINUTES سيتم تطبيق تحديد عدد مرات الظهور على عدد من الدقائق.