自
2025 年 9 月 8 日起,每个新订单项都需要声明是否会投放欧盟 (EU) 政治广告。Display & Video 360 API 和未提供声明的 SDF 上传操作将会失败。如需详细了解如何更新集成以进行此声明,请参阅我们的
弃用页面。
Pacing
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
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 .
} |
字段 |
pacingPeriod |
enum (PacingPeriod )
必需。预算投放节奏所涵盖的时间段。 通过 automationType 在广告订单一级启用自动分配预算后,此字段将仅用于输出,默认为 PACING_PERIOD_FLIGHT 。
|
pacingType |
enum (PacingType )
必需。投放节奏类型,用于定义预算金额将如何在 pacingPeriod 中支出。 PACING_TYPE_ASAP 与广告订单的 pacingPeriod PACING_PERIOD_FLIGHT 不兼容。
|
联合字段 daily_max_value 。当 pacing_period 设为 PACING_PERIOD_DAILY 时,适用此字段。daily_max_value 只能是下列其中一项: |
dailyMaxMicros |
string (int64 format)
每天可支出的最高金额(以广告客户的币种为单位,以百万分之一表示)。 当预算基于货币时适用。必须大于 0。例如,如果货币的标准单位为 1.5,请将此字段设置为 1500000。 分配的值将按以下规则舍入到相关币种的整数可结算单位:任何小于单个可结算单位的正值都将向上舍入到一个可结算单位,任何大于单个可结算单位的值都将向下舍入到最接近的可结算值。例如,如果货币的可结算单位为 0.01,并且此字段设置为 10257770,则会向下舍入为 10250000,值为 10.25。如果设置为 505,则会向上舍入到 10000,值为 0.01。
|
dailyMaxImpressions |
string (int64 format)
每天可投放的展示次数上限。 当预算以展示次数为依据时适用。必须大于 0。
|
PacingPeriod
枚举 |
PACING_PERIOD_UNSPECIFIED |
此版本中未指定周期值或周期值未知。 |
PACING_PERIOD_DAILY |
系统会每天应用投放节奏设置。 |
PACING_PERIOD_FLIGHT |
节奏设置将应用于整个广告投放时段。 |
PacingType
枚举 |
PACING_TYPE_UNSPECIFIED |
此版本中未指定或未知节奏模式值。 |
PACING_TYPE_AHEAD |
仅适用于 PACING_PERIOD_FLIGHT 节奏周期。“提前”投放节奏的支出速度会比“均匀”投放节奏的支出速度稍快一些,以确保在广告系列投放期结束前用完所有预算。 |
PACING_TYPE_ASAP |
尽快用完所有投放安排预算。 |
PACING_TYPE_EVEN |
在每个时间段内支出一致的预算金额。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[],["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. |"]]