A partir de 8 de setembro de 2025, todos os novos itens de linha precisarão declarar se vão veicular anúncios políticos da União Europeia (UE). As APIs do Display & Video 360 e os uploads de SDF que não fornecem declarações vão falhar. Consulte nossa página de suspensões de uso para mais detalhes sobre como atualizar sua integração e fazer essa declaração.
Indica se o limite de frequência ilimitado é aplicado. Quando esse campo é definido como true, os campos de limite de frequência restantes não são aplicáveis.
[null,null,["Última atualização 2025-07-25 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. |"]]
