本頁面由 Cloud Translation API 翻譯而成。

從第 1 版遷移至第 2 版

上次更新時間：2022 年 12 月 6 日

遷移應用程式

從 v1 遷移至 v2 時，您必須更新端點網址以呼叫 v2，並更新應用程式，藉此因應破壞性變更。

如要使用 v2 而非 v1，您需要將要求更新為使用新的 v2 端點。

舉例來說，如要使用 v1 呼叫 advertisers.get 方法，請使用下列網址：

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

針對 v2，請將網址更新為：

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

如果您是透過用戶端程式庫向 API 發出要求，請使用最新版用戶端程式庫並更新設定以使用 v2。

第 2 版將推出多項破壞性變更。請詳閱下列操作說明，並根據您目前的 Display & Video 360 API 使用方式進行必要變更。

inventorySourceIds 欄位已移除。使用 TARGETING_TYPE_INVENTORY_SOURCE 的 AssignedTargetingOption 資源管理廣告空間來源指派作業。
下列 LineItemWarningMessage 列舉值已在 v2 中淘汰，不會再顯示於 LineItem.warningMessages 中：
- NO_POSITIVE_AUDIENCE_LIST_TARGETED
- APP_INSTALL_NO_CONVERSION_PIXEL
- TARGETING_REVOKED_OR_CLOSED_USER_LIST
- APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
- CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
- NO_CREATIVE_FOR_TARGETED_DEALS
- TARGETING_DEPRECATED_GEO_TARGET
triggerId 欄位已從 LineItemFlight 物件中移除，LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER 值已從 LineItemFlightDateType 列舉類型中移除。v2 不支援根據手動觸發條件啟用後設定委刊項的支出費用。

customBiddingAlgorithmState 和 modelReadiness 欄位已由 modelDetails 欄位取代，該欄位可為透過 CustomBiddingModelDetails 物件清單存取權的每個廣告主，提供現有演算法模型的完備性和停權狀態。

除了上述的破壞性變更外，第 2 版也會推出新功能。

如要瞭解初始推出後第 2 版後新增的功能，請參閱版本資訊。

在 v2 中，您可以使用 advertisers.lineItems 和 advertisers.lineItems.targetingTypes.assignedTargetingOptions 服務分別擷取 YouTube 委刊項和指定目標設定。API 提供唯讀存取權，也就是說，任何嘗試對這些委刊項發出的寫入要求都會傳回錯誤。YouTube 委刊項會是下列其中一個 LineItemType 值：

在第 2 版中，advertisers.lineItems 服務提供新的方法來取代批次要求，以提升效能並降低配額消耗：

您可以使用 advertisers.lineItems.bulkUpdate 為多個委刊項設定相同的欄位值。目前僅支援 entityStatus 欄位更新。
您可以使用 advertisers.lineItems.bulkEditAssignedTargetingOptions 在多個委刊項中新增或移除相同的指派指定目標選項。
您可以使用 advertisers.lineItems.bulkListAssignedTargetingOptions，在多個委刊項中列出指派的指定目標選項。
您可以使用 advertisers.lineItems.duplicate，在相同的廣告訂單中建立現有委刊項副本，以便複製所有設定和指定目標設定。

在第 2 版中，您可以使用 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions 服務中的新 create 和 delete 方法，編輯 InsertionOrder 資源的子集指定目標設定。下列指定類型可在廣告訂單層級全代管：