上次更新時間：2023 年 10 月 31 日
遷移應用程式
如要從第 2 版遷移至第 3 版，請更新端點網址以呼叫第 3 版，並更新應用程式以因應重大變更。
將 API 呼叫從第 2 版更新至第 3 版
如要使用 v3 而非 v2，請更新要求，改用新的 v3 端點。
舉例來說，如要使用 v2 呼叫 advertisers.get 方法，請使用下列網址：
GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId
如果是 v3，請將網址更新為下列網址：
GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId
如果您使用用戶端程式庫向 API 發出要求，請使用最新版的用戶端程式庫，並更新設定以使用 v3。
進行必要變更
我們將在第 3 版中推出多項重大變更。請詳閱下列操作說明，並根據您目前使用 Display & Video 360 API 的方式，進行必要的變更。
更新呼叫，擷取 YouTube 資源及其相關指定目標
YoutubeAdGroup和YoutubeAdGroupAd資源已由AdGroup和AdGroupAd資源取代。這些新資源提供的資訊與 v2 資源幾乎相同，但可能使用更新的欄位名稱或列舉類型。在整合作業中，將YoutubeAdGroup或YoutubeAdGroupAd資源的使用情形替換為AdGroup和AdGroupAd資源，並將對下列第 2 版服務的呼叫更新為對應的第 3 版服務：advertisers.youtubeAdGroupAds到advertisers.adGroupAdsadvertisers.youtubeAdGroups到advertisers.adGroupsadvertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions至advertisers.adGroups.targetingTypes.assignedTargetingOptions
YoutubeAndPartnersBiddingStrategy物件的參照已移至一般BiddingStrategy物件中的新youtubeAndPartnersBid欄位。「biddingStrategy」欄位已從「YoutubeAndPartnersSettings」物件中移除。更新整合，從LineItem或AdGroup資源的bidStrategy欄位中，擷取 YouTube 委刊項或廣告群組的BiddingStrategy物件出價策略。YoutubeAndPartnersSettings物件中的thirdPartyMeasurementSettings欄位已重新命名為thirdPartyMeasurementConfigs，而YoutubeAndPartnersThirdPartyMeasurementSettings物件已重新命名為ThirdPartyMeasurementConfigs。更新整合服務，使用新欄位和物件擷取第三方評估設定資訊。
建立廣告主時，請加入必要的帳單設定
billingConfig 現在是 Advertiser 資源的必填欄位。更新advertisers.create要求，確認已設定這個欄位。透過新的 Partner 資源 billingConfig 欄位，即可擷取上層合作夥伴的預設帳單資訊。
使用新欄位控制最佳化指定目標
新的布林值 enableOptimizedTargeting 欄位已取代 TargetingExpansionConfig 物件中的 targetingExpansionLevel 欄位。
更新廣告訂單整合，使用新的 KPI 欄位
InsertionOrder 資源中的 performanceGoal 欄位已由新的 kpi 欄位取代。這個新欄位會使用 Kpi 物件取代 PerformanceGoal 物件，並使用新的欄位和列舉。
移除對已淘汰服務和欄位的參照
為配合先前淘汰的功能，第 3 版已移除多個實體：
advertisers.manualTriggers服務已移除，因為手動觸發程序已淘汰。billableOutcome欄位已從InsertionOrder資源中移除，因為依據結果採購已遭淘汰。
其他異動
除了上述破壞性變更，第 3 版也導入了新功能。
如要瞭解初始發布後在第 3 版中新增的功能，請參閱版本資訊。
管理鄰近位置清單
在第 3 版中，您可以全面管理鄰近地區位置清單，使用 advertisers.locationLists.assignedLocations 服務建立及刪除指派給 TARGETING_LOCATION_TYPE_PROXIMITY
LocationList 資源的位置。地點是使用 TARGETING_TYPE_POI TargetingOption 資源的 ID 識別。這些廣告可以透過 targetingTypes.targetingOptions.search 擷取。
可建立以規則為準的自訂出價演算法
在第 3 版中，您可以使用 customBiddingAlgorithms、media、customBiddingAlgorithms.rules 服務，建構及擷取以規則為準的自訂出價演算法。
這項功能目前為 Beta 版，僅供已加入許可清單的合作夥伴使用。如果合作夥伴不在允許清單中，要求會傳回錯誤。