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.
FrequencyCap
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Configurações que controlam o número de vezes que o mesmo anúncio pode ser mostrado para um usuário em um determinado período.
| Representação JSON |
{
"unlimited": boolean,
"timeUnit": enum (TimeUnit),
"timeUnitCount": integer,
"maxImpressions": integer,
"maxViews": integer
} |
| Campos |
unlimited |
boolean
Se o limite de frequência ilimitado foi aplicado. Quando esse campo é definido como true, os campos de limite de frequência restantes não são aplicáveis.
|
timeUnit |
enum (TimeUnit)
A unidade de tempo em que o limite de frequência será aplicado. Obrigatório quando unlimited é false.
|
timeUnitCount |
integer
O número de timeUnit que o limite de frequência vai durar. Obrigatório quando unlimited é false. As restrições a seguir são aplicadas com base no valor de timeUnit:
TIME_UNIT_MONTHS: precisa ser 1.TIME_UNIT_WEEKS: precisa estar entre 1 e 4TIME_UNIT_DAYS: precisa estar entre 1 e 6TIME_UNIT_HOURS: precisa estar entre 1 e 23TIME_UNIT_MINUTES: precisa estar entre 1 e 59
|
maxImpressions |
integer
É o número máximo de vezes que o mesmo anúncio pode ser mostrado a um usuário durante esse período. Precisa ser maior que 0. Obrigatório quando unlimited é false e maxViews não está definido.
|
maxViews |
integer
Opcional. É o número máximo de vezes que um usuário pode clicar ou visualizar um anúncio durante esse período até que ele não seja mais veiculado. Precisa ser maior que 0. Aplicável apenas aos recursos do YouTube e dos parceiros. Obrigatório quando unlimited é false e maxImpressions não está definido.
|
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 2025-07-25 UTC."],[],[],null,["# FrequencyCap\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\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/v4/TimeUnit), \"timeUnitCount\": integer, \"maxImpressions\": integer, \"maxViews\": 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/v4/TimeUnit)`)` The time unit in which the frequency cap will be applied. Required when [unlimited](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.unlimited) is `false`. |\n| `timeUnitCount` | `integer` The number of [timeUnit](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.time_unit) the frequency cap will last. Required when [unlimited](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.unlimited) is `false`. The following restrictions apply based on the value of [timeUnit](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.time_unit): - `TIME_UNIT_MONTHS` - must be 1 - `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/v4/FrequencyCap#FIELDS.unlimited) is `false` and [maxViews](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.max_views) is not set. |\n| `maxViews` | `integer` Optional. The maximum number of times a user may click-through or fully view an ad during this period until it is no longer served to them. Must be greater than 0. Only applicable to YouTube and Partners resources. Required when [unlimited](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.unlimited) is `false` and [maxImpressions](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.max_impressions) is not set. |"]]
