從第 2 版遷移至第 3 版

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

遷移應用程式

從第 2 版遷移至第 3 版時，您必須更新端點網址以呼叫 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 使用情形，進行必要的變更。

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

billingConfig 現已是 Advertiser 資源中的必填欄位。更新 advertisers.create 要求，確認是否已設定這個欄位。您可以透過新的 Partner 資源 billingConfig 欄位，為上層合作夥伴擷取預設帳單資訊。

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

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

更新廣告訂單整合功能，使用新的 KPI 欄位

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

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

為配合過去功能的淘汰，我們已在 v3 中移除各種實體：

其他異動

除了上述破壞性變更，v3 也推出了新功能。

在初次推出後新增至 v3 的功能，請參閱發布說明。

鄰近區域清單管理

在 v3 中，您可以全面管理鄰近位置清單，並使用 advertisers.locationLists.assignedLocations 服務建立及刪除指派給 TARGETING_LOCATION_TYPE_PROXIMITY LocationList 資源的位置。系統會使用 TARGETING_TYPE_POI TargetingOption 資源的 ID 識別位置。您可以使用 targetingTypes.targetingOptions.search 擷取這些資料。

能夠建立以規則為依據的自訂出價演算法

在 v3 中，您可以使用 customBiddingAlgorithms、media 和 customBiddingAlgorithms.rules 服務，建立及擷取以規則為依據的自訂出價演算法。

這項功能目前為 Beta 版，僅供獲准的合作夥伴使用。如果合作夥伴未列入許可清單，您的要求會傳回錯誤。