上次更新時間：2023 年 10 月 31 日
遷移應用程式
從 v2 遷移至 v3 時，您必須更新端點網址以呼叫 v3，並更新應用程式，藉此因應破壞性變更。
將 API 呼叫從 v2 更新為 v3
如要使用 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 資源幾乎相同，但可使用更新的欄位名稱或列舉類型。在整合項目中，使用AdGroup和AdGroupAd資源取代YoutubeAdGroup或YoutubeAdGroupAd資源的使用方式，並將下列 v2 服務的呼叫更新為相應的 v3 服務：advertisers.youtubeAdGroupAds到advertisers.adGroupAdsadvertisers.youtubeAdGroups到advertisers.adGroupsadvertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions到advertisers.adGroups.targetingTypes.assignedTargetingOptions
YoutubeAndPartnersBiddingStrategy物件的參照已移至一般BiddingStrategy物件中的新youtubeAndPartnersBid欄位。已從YoutubeAndPartnersSettings物件中移除biddingStrategy欄位。更新整合，從LineItem或AdGroup資源的bidStrategy欄位中，透過BiddingStrategy物件擷取 YouTube 委刊項或廣告群組的出價策略。YoutubeAndPartnersSettings物件的thirdPartyMeasurementSettings欄位已重新命名為thirdPartyMeasurementConfigs，而YoutubeAndPartnersThirdPartyMeasurementSettings物件已重新命名為ThirdPartyMeasurementConfigs。更新整合，以使用新欄位和物件擷取第三方評估設定資訊。
建立廣告主時，加入必要的帳單設定
billingConfig 現在是 Advertiser 資源中的必填欄位。請更新 advertisers.create 要求，確認這個欄位已設定完畢。您可以透過新的 Partner 資源 billingConfig 欄位，擷取上層合作夥伴的預設帳單資訊。
使用新欄位控管最佳化指定目標對象
新的布林值 enableOptimizedTargeting 欄位已取代 TargetingExpansionConfig 物件中的 targetingExpansionLevel 欄位。
更新廣告訂單整合功能，以便使用新的 KPI 欄位
新的 kpi 欄位已取代 InsertionOrder 資源中的 performanceGoal 欄位。這個新欄位會使用 Kpi 物件取代 PerformanceGoal 物件，並使用新的欄位和列舉。
移除已淘汰服務和欄位的參照
為配合先前淘汰的功能，第 3 版已移除多項實體：
advertisers.manualTriggers服務已移除，因為手動觸發條件已遭淘汰。- 「
billableOutcome」欄位已從InsertionOrder資源中移除，因為依據結果採購功能已淘汰。
其他異動
除了上述的破壞性變更外，第 3 版也提供新功能。
如要瞭解首次推出後在 v3 中新增的功能，請參閱版本資訊。
鄰近位置清單管理
在 v3 中，您可以完全管理鄰近位置清單，使用 advertisers.locationLists.assignedLocations 服務建立及刪除指派給 TARGETING_LOCATION_TYPE_PROXIMITY
LocationList 資源的位置。系統會使用 TARGETING_TYPE_POI TargetingOption 資源的 ID 來識別位置。您可以使用 targetingTypes.targetingOptions.search 擷取這些訊息。
可建立規則式自訂出價演算法
在 v3 中，您可以使用 customBiddingAlgorithms、media 和 customBiddingAlgorithms.rules 服務，建構及擷取規則式自訂出價演算法。
這項功能目前仍為 Beta 版，僅供許可清單上的合作夥伴使用。如果您的合作夥伴未加入許可清單，要求會傳回錯誤。