從第 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 使用情形，進行必要的變更。

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

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

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

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

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

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

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

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

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

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

• 由於手動觸發事件已淘汰，因此已移除 advertisers.manualTriggers 服務。
• 由於依據結果採購已遭淘汰，billableOutcome 欄位已從 InsertionOrder 資源中移除。

其他異動

除了上述破壞性變更，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 版，僅供獲准的合作夥伴使用。如果合作夥伴未列入許可清單，您的要求會傳回錯誤。