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.
Pacing
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Configurações que controlam a taxa em que um orçamento é gasto.
Representação JSON |
{
"pacingPeriod": enum (PacingPeriod ),
"pacingType": enum (PacingType ),
// Union field daily_max_value can be only one of the following:
"dailyMaxMicros": string,
"dailyMaxImpressions": string
// End of list of possible types for union field daily_max_value .
} |
Campos |
pacingPeriod |
enum (PacingPeriod )
Obrigatório. O período em que o orçamento de desempenho orçamentário será gasto. Quando a alocação automática de orçamento é ativada no pedido de inserção usando automationType , esse campo é somente de saída e o padrão é PACING_PERIOD_FLIGHT .
|
pacingType |
enum (PacingType )
Obrigatório. O tipo de ritmo que define como o valor do orçamento será gasto na pacingPeriod . O PACING_TYPE_ASAP não é compatível com pacingPeriod PACING_PERIOD_FLIGHT para pedidos de inserção.
|
Campo de união daily_max_value . Aplicável quando pacing_period está definido como PACING_PERIOD_DAILY . daily_max_value pode ser apenas um dos seguintes: |
dailyMaxMicros |
string (int64 format)
Valor máximo da moeda a ser gasto todos os dias em micros da moeda do anunciante. Aplicável quando o orçamento é baseado em moeda. Precisa ser maior que 0. Por exemplo, para 1,5 unidade padrão da moeda, defina esse campo como 1500000. O valor atribuído será arredondado para unidades faturáveis inteiras da moeda relevante de acordo com as seguintes regras: qualquer valor positivo menor que uma unidade faturável será arredondado para uma unidade faturável, e qualquer valor maior que uma unidade faturável será arredondado para o valor faturável mais próximo. Por exemplo, se a unidade faturável da moeda for 0,01 e esse campo estiver definido como 10257770, ele será arredondado para 10250000, um valor de 10,25. Se definido como 505, ele será arredondado para 10000, um valor de 0,01.
|
dailyMaxImpressions |
string (int64 format)
Número máximo de impressões a serem veiculadas por dia. Aplicável quando o orçamento é baseado em impressões. Precisa ser maior que 0.
|
PacingPeriod
Períodos de tempo possíveis usados para gastar o valor do ritmo.
Enums |
PACING_PERIOD_UNSPECIFIED |
O valor do período não foi especificado ou é desconhecido nesta versão. |
PACING_PERIOD_DAILY |
A configuração do ritmo será aplicada diariamente. |
PACING_PERIOD_FLIGHT |
A configuração de ritmo será aplicada a toda a duração do voo. |
PacingType
Possíveis tipos de ritmo.
Enums |
PACING_TYPE_UNSPECIFIED |
O valor do modo de ritmo não foi especificado ou é desconhecido nesta versão. |
PACING_TYPE_AHEAD |
Aplicável apenas ao período de controle de ritmo PACING_PERIOD_FLIGHT . O andamento "Antecedência" tenta gastar o orçamento mais rápido do que o "Uniforme", para garantir que todo o orçamento seja gasto até o final do período de veiculação. |
PACING_TYPE_ASAP |
Gaste todo o valor do orçamento de andamento o mais rápido possível. |
PACING_TYPE_EVEN |
Gaste um valor de orçamento consistente a cada período. |
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."],[],["The Display & Video 360 API v4 beta includes settings to control budget spending rates. Key parameters are `pacingPeriod` (timeframe: daily or flight duration) and `pacingType` (spending mode: even, ahead, or ASAP). When `pacingPeriod` is daily, `dailyMaxMicros` or `dailyMaxImpressions` define the maximum daily budget. `dailyMaxMicros` applies to currency-based budgets and must be above zero, values will be rounded to whole billable units. `dailyMaxImpressions` refers to the max number of impressions to serve each day.\n"],null,["# Pacing\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [PacingPeriod](#PacingPeriod)\n- [PacingType](#PacingType)\n\nSettings that control the rate at which a budget is spent.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"pacingPeriod\": enum (/display-video/api/reference/rest/v4/Pacing#PacingPeriod), \"pacingType\": enum (/display-video/api/reference/rest/v4/Pacing#PacingType), // Union field `daily_max_value` can be only one of the following: \"dailyMaxMicros\": string, \"dailyMaxImpressions\": string // End of list of possible types for union field `daily_max_value`. } ``` |\n\n| Fields ||\n|-----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pacingPeriod` | `enum (`[PacingPeriod](/display-video/api/reference/rest/v4/Pacing#PacingPeriod)`)` Required. The time period in which the pacing budget will be spent. When automatic budget allocation is enabled at the insertion order via [automationType](/display-video/api/reference/rest/v4/advertisers.insertionOrders#InsertionOrderBudget.FIELDS.automation_type), this field is output only and defaults to `PACING_PERIOD_FLIGHT`. |\n| `pacingType` | `enum (`[PacingType](/display-video/api/reference/rest/v4/Pacing#PacingType)`)` Required. The type of pacing that defines how the budget amount will be spent across the [pacingPeriod](/display-video/api/reference/rest/v4/Pacing#FIELDS.pacing_period). `PACING_TYPE_ASAP` is not compatible with [pacingPeriod](/display-video/api/reference/rest/v4/Pacing#FIELDS.pacing_period) `PACING_PERIOD_FLIGHT` for insertion orders. |\n| Union field `daily_max_value`. Applicable when [pacing_period](/display-video/api/reference/rest/v4/Pacing#FIELDS.pacing_period) is set to be `PACING_PERIOD_DAILY`. `daily_max_value` can be only one of the following: ||\n| `dailyMaxMicros` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Maximum currency amount to spend every day in micros of advertiser's currency. Applicable when the budget is currency based. Must be greater than 0. For example, for 1.5 standard unit of the currency, set this field to 1500000. The value assigned will be rounded to whole billable units for the relevant currency by the following rules: any positive value less than a single billable unit will be rounded up to one billable unit and any value larger than a single billable unit will be rounded down to the nearest billable value. For example, if the currency's billable unit is 0.01, and this field is set to 10257770, it will round down to 10250000, a value of 10.25. If set to 505, it will round up to 10000, a value of 0.01. |\n| `dailyMaxImpressions` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Maximum number of impressions to serve every day. Applicable when the budget is impression based. Must be greater than 0. |\n\nPacingPeriod\n------------\n\nPossible time periods used to spend to the pacing amount.\n\n| Enums ||\n|-----------------------------|------------------------------------------------------------------|\n| `PACING_PERIOD_UNSPECIFIED` | Period value is not specified or is unknown in this version. |\n| `PACING_PERIOD_DAILY` | The pacing setting will be applied on daily basis. |\n| `PACING_PERIOD_FLIGHT` | The pacing setting will be applied to the whole flight duration. |\n\nPacingType\n----------\n\nPossible pacing types.\n\n| Enums ||\n|---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `PACING_TYPE_UNSPECIFIED` | Pacing mode value is not specified or is unknown in this version. |\n| `PACING_TYPE_AHEAD` | Only applicable to `PACING_PERIOD_FLIGHT` pacing period. Ahead pacing attempts to spend faster than evenly, to make sure the entire budget is spent by the end of the flight. |\n| `PACING_TYPE_ASAP` | Spend all of pacing budget amount as quick as possible. |\n| `PACING_TYPE_EVEN` | Spend a consistent budget amount every period of time. |"]]