自
2025 年 9 月 8 日起,每個新委刊項都必須聲明是否會放送歐盟政治廣告。如果透過 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 |
在每個時間範圍內支出一致的預算金額。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間: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. |"]]