StartingSeptember 8, 2025, every new line item will need to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See ourdeprecations pagefor more details on how to update your integration to make this declaration.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 UTC."],[[["\u003cp\u003eFrequency caps control the number of times a user sees the same ad within a specific timeframe.\u003c/p\u003e\n"],["\u003cp\u003eThese settings include options for unlimited capping or defining limits based on various time units (lifetime, months, weeks, days, hours, minutes).\u003c/p\u003e\n"],["\u003cp\u003eWhen setting frequency caps, you must specify the time unit and the maximum number of impressions allowed during that period.\u003c/p\u003e\n"],["\u003cp\u003eSpecific restrictions apply to the duration of frequency caps depending on the chosen time unit (e.g., months must be between 1 and 2).\u003c/p\u003e\n"]]],[],null,["# FrequencyCap\n\n| Display \\& Video 360 API v1 has been sunset.\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [TimeUnit](#TimeUnit)\n\nSettings that control the number of times a user may be shown with the same ad during a given time period.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"unlimited\": boolean, \"timeUnit\": enum (/display-video/api/reference/rest/v1/FrequencyCap#TimeUnit), \"timeUnitCount\": integer, \"maxImpressions\": integer } ``` |\n\n| Fields ||\n|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `unlimited` | `boolean` Whether unlimited frequency capping is applied. When this field is set to `true`, the remaining frequency cap fields are not applicable. |\n| `timeUnit` | `enum (`[TimeUnit](/display-video/api/reference/rest/v1/FrequencyCap#TimeUnit)`)` The time unit in which the frequency cap will be applied. Required when [unlimited](/display-video/api/reference/rest/v1/FrequencyCap#FIELDS.unlimited) is `false`. |\n| `timeUnitCount` | `integer` The number of [timeUnit](/display-video/api/reference/rest/v1/FrequencyCap#FIELDS.time_unit) the frequency cap will last. Required when [unlimited](/display-video/api/reference/rest/v1/FrequencyCap#FIELDS.unlimited) is `false`. The following restrictions apply based on the value of [timeUnit](/display-video/api/reference/rest/v1/FrequencyCap#FIELDS.time_unit): - `TIME_UNIT_LIFETIME` - this field is output only and will default to 1 - `TIME_UNIT_MONTHS` - must be between 1 and 2 - `TIME_UNIT_WEEKS` - must be between 1 and 4 - `TIME_UNIT_DAYS` - must be between 1 and 6 - `TIME_UNIT_HOURS` - must be between 1 and 23 - `TIME_UNIT_MINUTES` - must be between 1 and 59 |\n| `maxImpressions` | `integer` The maximum number of times a user may be shown the same ad during this period. Must be greater than 0. Required when [unlimited](/display-video/api/reference/rest/v1/FrequencyCap#FIELDS.unlimited) is `false`. |\n\nTimeUnit\n--------\n\nPossible time units.\n\n| Enums ||\n|-------------------------|----------------------------------------------------------------------------|\n| `TIME_UNIT_UNSPECIFIED` | Time unit value is not specified or is unknown in this version. |\n| `TIME_UNIT_LIFETIME` | The frequency cap will be applied to the whole life time of the line item. |\n| `TIME_UNIT_MONTHS` | The frequency cap will be applied to a number of months. |\n| `TIME_UNIT_WEEKS` | The frequency cap will be applied to a number of weeks. |\n| `TIME_UNIT_DAYS` | The frequency cap will be applied to a number of days. |\n| `TIME_UNIT_HOURS` | The frequency cap will be applied to a number of hours. |\n| `TIME_UNIT_MINUTES` | The frequency cap will be applied to a number of minutes. |"]]
