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

יחידות זמן אפשריות.

טיפוסים בני מנייה (enum)
TIME_UNIT_UNSPECIFIED ערך יחידת הזמן לא צוין או שאינו ידוע בגרסה זו.
TIME_UNIT_LIFETIME מכסת התדירות תחול על כל משך החיים של הפריט.
TIME_UNIT_MONTHS מכסת התדירות תחול על מספר חודשים.
TIME_UNIT_WEEKS מכסת התדירות תחול על מספר שבועות.
TIME_UNIT_DAYS מכסת התדירות תחול על מספר ימים.
TIME_UNIT_HOURS מכסת התדירות תחול על מספר שעות.
TIME_UNIT_MINUTES מכסת התדירות תחול על מספר דקות.