上次更新時間: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.adGroupAds
advertisers.youtubeAdGroups
到advertisers.adGroups
advertisers.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 版,僅供許可清單上的合作夥伴使用。如果您的合作夥伴未加入許可清單,要求會傳回錯誤。