從第 1 版遷移至第 2 版

上次更新時間：2022-12-06

遷移應用程式

從 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。

我們會在 v2 中推出多項破壞性變更。請詳閱下列操作說明，並根據您現有的 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 在同一個廣告訂單中複製現有委刊項，並複製所有設定和指定目標設定。

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