從第 1 版遷移至第 2 版

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

遷移應用程式

若要從第 1 版遷移至第 2 版，您必須更新端點網址，以呼叫 v2 和 更新應用程式，以利處理破壞性變更。

將 API 呼叫從 v1 更新為 v2

如要使用第 2 版取代第 1 版，請將要求改為使用新的 v2。 端點。

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

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

如果是第 2 版，請將網址更新為下列內容：

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

如果您使用用戶端程式庫來向 API 發出要求，請採用 最新版本的用戶端程式庫，並將設定更新為使用 v2。

進行必要變更

我們將在第 2 版中推出幾項破壞性變更。請詳閱下列項目 並根據目前的 多媒體和Video 360 API。

更新指定方式的呼叫

• 部分指定類型現在以列舉值進行指派，而不是指定目標 選項 ID。舉例來說，系統現在是透過 DEVICE_TYPE_TABLET DeviceType 列舉， 而不是指定目標選項 ID targetingTypes.targetingOptions 服務。字串版本 這些列舉會在新的 assignedTargetingOptionIdAlias 欄位 AssignedTargetingOption 資源，可用來擷取或 正在刪除現有指定目標。assignedTargetingOptionId 值 其中 AssignedTargetingOption 項資源並未變更。

  更新管理下列指定類型的呼叫，以便使用列舉值：

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

• advertisers.lineItems.bulkEditLineItemAssignedTargetingOptions 方法 已由方法取代 advertisers.lineItems.bulkEditAssignedTargetingOptions。

• advertisers.lineItems.bulkListLineItemAssignedTargetingOptions 方法 已由方法取代 advertisers.lineItems.bulkListAssignedTargetingOptions。

• 更新管理「TARGETING_TYPE_PROXIMITY_LOCATION_LIST」的通話 使用一組指定的半徑大小和 距離單位，而非 ProximityRadiusRange 列舉值。

• 用來擷取或修改多個多個指定目標選項的指定方式 單一父項資源下的指定類型已經重新命名。

  更新以下方法的呼叫，以使用新名稱：

  • advertisers.bulkEditAdvertiserAssignedTargetingOptions 至 advertisers.editAssignedTargetingOptions。
  • advertisers.bulkListAdvertiserAssignedTargetingOptions 至 advertisers.listAssignedTargetingOptions。
  • advertisers.campaigns.bulkListCampaignAssignedTargetingOptions 至 advertisers.campaigns.listAssignedTargetingOptions。
  • advertisers.insertionOrders.bulkListInsertionOrderAssignedTargetingOptions 至 advertisers.insertionOrders.listAssignedTargetingOptions
  • partners.bulkEditPartnerAssignedTargetingOptions 到 partners.editAssignedTargetingOptions。

更新呼叫「advertisers.lineItems」服務的呼叫

• 已移除「inventorySourceIds」欄位。管理 使用 AssignedTargetingOption 資源指派廣告空間來源 (共 TARGETING_TYPE_INVENTORY_SOURCE 個)。

• 下列 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 列舉類型。第 2 版不支援 根據手動觸發條件啟用的方式，將委刊項設為支出。

更新呼叫「customBiddingAlgorithms」服務的呼叫

customBiddingAlgorithmState 和 modelReadiness 欄位已替換為 modelDetails 欄位，提供完備性 和現有演算法的停權狀態 系統會為每個廣告客戶提供專屬的模式 CustomBiddingModelDetails 物件。

其他異動

除了上述破壞性變更之外，第 2 版也導入了新的 接著介紹網際網路通訊層 包括兩項主要的安全防護功能

如要瞭解初次推出後新增至 v2 的功能，請參閱 版本資訊。

具備 YouTube 委刊項的唯讀存取權

在第 2 版中，您可以使用 advertisers.lineItems 和 advertisers.lineItems.targetingTypes.assignedTargetingOptions。 及服務。此 API 提供唯讀存取權， 試圖寫入這些委刊項時，系統會傳回錯誤。YouTube 委刊項會是下列其中一種LineItemType 值：

• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

提升成效的新方法

在 v2 中，advertisers.lineItems 服務提供 取代批次要求的方法 並減少配額用量：

• 您可以使用 advertisers.lineItems.bulkUpdate 來設定 相同欄位值只對 目前支援 entityStatus 欄位。
• 別擔心！您可以使用 advertisers.lineItems.bulkEditAssignedTargetingOptions敬上 在多個行新增或移除同一個指派指定目標選項 項目。
• 別擔心！您可以使用 advertisers.lineItems.bulkListAssignedTargetingOptions敬上 列出多個委刊項的指定選項
• 您可以使用 advertisers.lineItems.duplicate 建立副本 複製到相同廣告訂單中現有委刊項的 和指定目標設定

廣告訂單指定目標的部分寫入權限

在 v2 中，您可以修改「InsertionOrder」的部分指定目標設定 和使用新的 create 和 delete 方法 (位於 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions 課程中也會快速介紹 Memorystore 這是 Google Cloud 的全代管 Redis 服務以下指定類型可在插入功能時完全管理 訂單層級：

• TARGETING_TYPE_AGE_RANGE
• TARGETING_TYPE_BROWSER
• TARGETING_TYPE_CATEGORY
• TARGETING_TYPE_CHANNEL
• TARGETING_TYPE_DEVICE_MAKE_MODEL
• TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
• TARGETING_TYPE_ENVIRONMENT
• TARGETING_TYPE_GENDER
• TARGETING_TYPE_KEYWORD
• TARGETING_TYPE_LANGUAGE
• TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
• TARGETING_TYPE_OPERATING_SYSTEM
• TARGETING_TYPE_PARENTAL_STATUS
• TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
• TARGETING_TYPE_VIEWABILITY