每个新订单项都需要声明是否会投放欧盟 (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-09-10。
[null,null,["最后更新时间 (UTC):2025-09-10。"],[[["\u003cp\u003ePacing settings manage the rate at which a budget is spent, either daily or over the entire campaign duration.\u003c/p\u003e\n"],["\u003cp\u003eYou can control spending by setting daily limits for currency or impressions.\u003c/p\u003e\n"],["\u003cp\u003ePacing types allow you to spend evenly, quickly ("ASAP"), or ahead of schedule to exhaust the budget by the campaign's end.\u003c/p\u003e\n"],["\u003cp\u003eStarting November 5, 2024, the "ASAP" pacing type will no longer work with campaign-duration pacing for insertion orders.\u003c/p\u003e\n"]]],["Pacing settings control budget spending rates, defined by `pacingPeriod` and `pacingType`. `pacingPeriod` specifies the time frame (daily or flight duration), with `PACING_PERIOD_FLIGHT` as the default for automated budget allocation. `pacingType` dictates spending behavior (ASAP, ahead, or evenly), with `PACING_TYPE_ASAP` being incompatible with `PACING_PERIOD_FLIGHT`. For daily pacing, `dailyMaxMicros` sets the maximum daily currency spending, and `dailyMaxImpressions` sets the maximum number of daily impressions.\n"],null,["| Display \\& Video 360 API v3 is deprecated and will sunset on **October 7, 2025** . Migrate to [Display \\& Video 360 API v4](/display-video/api/reference/rest/v4) before sunset to avoid an interruption in service.\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/v3/Pacing#PacingPeriod), \"pacingType\": enum (/display-video/api/reference/rest/v3/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/v3/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/v3/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/v3/Pacing#PacingType)`)` Required. The type of pacing that defines how the budget amount will be spent across the [pacingPeriod](/display-video/api/reference/rest/v3/Pacing#FIELDS.pacing_period). `PACING_TYPE_ASAP` is not compatible with [pacingPeriod](/display-video/api/reference/rest/v3/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/v3/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 Possible 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 Possible 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. |"]]