從第 2 版遷移至第 3 版

上次更新時間：2023 年 10 月 31 日

遷移應用程式

若要從第 2 版遷移至第 3 版，您必須更新端點網址，以呼叫 v3。 更新應用程式，以利處理破壞性變更。

將 API 呼叫從 v2 更新為 v3

如要使用第 3 版取代第 2 版，請將要求更新為使用新的 v3。 端點。

舉例來說，如要使用第 2 版呼叫 advertisers.get 方法，您必須 使用下列網址：

GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId

如果是第 3 版，請將網址更新為下列內容：

GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId

如果您使用用戶端程式庫來向 API 發出要求，請採用 最新版本的用戶端程式庫，並將設定更新為使用 v3。

進行必要變更

我們將在第 3 版中推出幾項破壞性變更。請詳閱下列項目 並根據目前的 多媒體和Video 360 API。

更新呼叫來擷取 YouTube 資源及其相關指定目標

• YoutubeAdGroup 和 YoutubeAdGroupAd 資源已由 AdGroup 和 AdGroupAd 資源。這些新資源提供了 與第 2 版資源幾乎相同，但可能會使用更新後的欄位 或列舉類型在整合項目中，將 YoutubeAdGroup 或 YoutubeAdGroupAd 項資源，具有AdGroup和 AdGroupAd 資源，並將對下列 v2 服務的呼叫更新為 並納入對應的 v3 服務：
  • advertisers.youtubeAdGroupAds到 advertisers.adGroupAds
  • advertisers.youtubeAdGroups到 advertisers.adGroups
  • advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions到 advertisers.adGroups.targetingTypes.assignedTargetingOptions
• YoutubeAndPartnersBiddingStrategy 物件的參照 已移至新的「youtubeAndPartnersBid」欄位 一般 BiddingStrategy 物件內。 「biddingStrategy」欄位已從 YoutubeAndPartnersSettings 物件。將整合項目更新為： 請從網頁擷取 YouTube 委刊項或廣告群組的出價策略 位於 bidStrategy 欄位中的 BiddingStrategy 物件 LineItem 或 AdGroup 資源。
• thirdPartyMeasurementSettings 欄位已重新命名為 thirdPartyMeasurementConfigs 的 YoutubeAndPartnersSettings 物件和 YoutubeAndPartnersThirdPartyMeasurementSettings 物件已重新命名為 ThirdPartyMeasurementConfigs。將整合項目更新為： 使用新欄位擷取第三方評估設定資訊 和物件

建立廣告主時加入必要的帳單設定

billingConfig 是 Advertiser 資源。更新您的 advertisers.create 要求確認欄位設定是否設定完成。預設的帳單資訊可以 透過新的 Partner 擷取給上層合作夥伴 資源 billingConfig 欄位。

使用新欄位控制最佳化指定目標對象

新的布林值 enableOptimizedTargeting 欄位已取代 TargetingExpansionConfig 中的 targetingExpansionLevel 欄位 物件。

更新廣告訂單整合以使用新的 KPI 欄位

新的 kpi 欄位已取代performanceGoal InsertionOrder 資源。這個新欄位使用 Kpi 物件取代 PerformanceGoal 物件，並使用新欄位和列舉。

移除對已淘汰服務和欄位的參照

為配合過往功能，第 3 版中移除了多個實體 淘汰項目：

• 已移除 advertisers.manualTriggers 服務，做為手動觸發條件
• billableOutcome 欄位已從 InsertionOrder 資源，因為根據結果採購 已淘汰。

其他異動

除了上述破壞性變更之外，第 3 版也導入了新的 接著介紹網際網路通訊層 包括兩項主要的安全防護功能

您可以在我們的版本中找到初次推出 v3 後新增的功能 附註。

鄰近地區清單管理

在第 3 版中，您可以完全管理鄰近地點清單，以便： 使用 advertisers.locationLists.assignedLocations 服務 建立及刪除指派給 TARGETING_LOCATION_TYPE_PROXIMITY 的位置 LocationList 資源。位置的識別依據為 TARGETING_TYPE_POI TargetingOption 資源。您可以輸入 使用 targetingTypes.targetingOptions.search 擷取。

可建立規則式自訂出價演算法

在第 3 版中，您可以使用 customBiddingAlgorithms、media、 customBiddingAlgorithms.rules 服務。

這項功能仍處於 Beta 版測試階段，僅供許可清單中的合作夥伴使用。如果您的 合作夥伴未加入許可清單，您的要求就會傳回錯誤。