我們已停用 Display & Video 360 API v1，且對這個 API 第 1 版發出的要求可能會傳回錯誤。您必須改用 Display & Video 360 API 第 2 版。

如需從 v1 遷移至 v2 的操作說明，請參閱我們的遷移指南。

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

Switch to English

從 v1 遷移至第 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 資源管理廣告空間來源指派作業。
v2 已淘汰下列 LineItemWarningMessage 列舉值，不會再顯示於 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 物件清單存取。

除了上述破壞性變更之外，v2 也提供新功能。

在初始啟動後加入第 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，在相同的廣告訂單中建立現有委刊項的副本，然後複製所有設定和指定目標設定。

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