公告淘汰

本頁面列出 Display & Video 360 API 中 API 版本和個別功能的淘汰日期和停用日期。

此外，Google Ads 開發人員網誌也會公告 API 的停用和終止日期。

版本淘汰項目

Display & Video 360 API 版本會定期發布、淘汰並停用。這些步驟的定義如下：

  • 版本：版本會退出任何 Alpha 或 Beta 版狀態，且視為穩定版。該版本可能仍會發布功能新增內容。
  • 淘汰：這個版本即將淘汰，並公告停止支援 (停用) 日期。使用者必須在服務終止日期前遷移至新版本。這個版本將不再發布新功能，
  • Sunset：系統已不再支援這個版本。向該版本發出的要求會傳回錯誤。

下表列出所有現有的 Display & Video 360 API 核心版本、其發布日期，以及淘汰日期和停用日期 (如有公告)。

API 版本 發布日期 淘汰日期 停用日期 遷移指南
v3 2023 年 10 月 31 日
v2 2022 年 12 月 6 日 2024 年 2 月 15 日 2024 年 9 月 3 日 從第 2 版遷移至第 3 版
v1 2020 年 3 月 9 日 2023 年 3 月 13 日 2023 年 9 月 14 日 從 v1 遷移至第 2 版

淘汰功能

請追蹤 Google Ads 開發人員網誌，查看即將推出的重要功能淘汰公告。

下表列出所有公告功能淘汰項目，並提供初始生效日期及淘汰說明，並附上建議採取的行動和相關說明文件的連結：

功能 初始生效日期 說明
擴展指定目標 2023 年 3 月 25 日 我們已將擴展指定目標功能取代為最佳化指定目標對象，已於 2023 年 3 月 25 日至 2023 年 5 月初逐步推出。這篇網誌文章發表了 Display & Video 360 API 和結構化資料檔案行為的相關異動，以及建議採取的行動。
手動觸發 2023 年 5 月 17 日

時間表：

  • 2023 年 5 月 17 日：使用手動觸發條件的委刊項將停止在 Display & Video 360 中放送。如果您在這個日期之後啟用與有效委刊項連結的手動觸發條件，委刊項就不會放送廣告。
  • 2023 年 8 月 1 日：DV360 API 第 1 版和第 2 版中的 advertisers.manualTriggers 服務、DV360 API v1 中的 LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER 列舉值，以及 DV360 API v1 中的 LineItemFlight.triggerId 欄位即將停用。上述日期過後，傳送至這些服務或這些欄位的要求都會傳回錯誤。

建議做法：
已安裝的應用程式和新的行動裝置 GoogleAudience 類型 2023 年 5 月 20 日

時間表：

  • 2023 年 5 月 20 日：您將無法再將 GoogleAudienceType 為 GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS 或 GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES 的 GoogleAudience 資源指派給委刊項或廣告訂單指定目標對象。將這些目標對象指派給委刊項的指定目標對象時，會傳回錯誤。如果建立的委刊項會在指定目標對像中納入已淘汰的目標對象，包括 advertisers.lineItems.duplicate 和 advertisers.lineItems.generateDefault 請求。
  • 2023 年 6 月 8 日：系統會從所有委刊項和廣告訂單指定目標，以及所有合併目標對像中移除受影響的目標對象。移除這些目標對象後，如果委刊項無法放送廣告，就會暫停。屆時，您就無法再使用 googleAudiences 服務擷取這些目標對象。

建議的工作：

  • 日後更新委刊項指定目標時，建議您立即停止使用受影響的目標對象。
  • 從現有委刊項和廣告訂單指定目標中移除所有受影響的目標對象。如要瞭解如何更新指定目標對象，請參閱「目標對象指南」。
以活動為依據與展示頻率上限 FirstAndThirdPartyAudience 類型 2023 年 5 月 20 日

時間表：

  • 2023 年 5 月 20 日：您將無法再將 AudienceType 為 ACTIVITY_BASED 或 FREQUENCY_CAP 的 FirstAndThirdPartyAudience 資源指派給委刊項或廣告訂單指定目標對象。將這些目標對象指派給委刊項的指定目標對象時，會傳回錯誤。如果建立的委刊項會在指定目標對像中納入已淘汰的目標對象，包括 advertisers.lineItems.duplicate 和 advertisers.lineItems.generateDefault 請求。
  • 2023 年 6 月 8 日：系統會從所有委刊項和廣告訂單指定目標，以及所有合併目標對像中移除受影響的目標對象。移除這些目標對象後，如果委刊項無法放送廣告，就會暫停。屆時，您就無法再使用 firstAndThirdPartyAudiences 服務擷取這些目標對象。

建議的工作：

  • 日後更新委刊項指定目標時，建議您立即停止使用受影響的目標對象。
  • 從現有委刊項和廣告訂單指定目標中移除所有受影響的目標對象。如要瞭解如何更新指定目標對象，請參閱「目標對象指南」。
現有的 API 配額限制 2023 年 5 月 30 日

自 2023 年 5 月 30 日起，現有的用量限制將更換為混合配額架構，並達成以下目標：

  1. 避免每項專案的每日要求數配額。
  2. 機構會針對符合資格的方法，設定每項專案每分鐘的個別要求數配額。

這些新的限制可讓 API 使用更具彈性，並可跨廣告客戶間的請求平行處理。如需這項異動的詳細資訊，請參閱現有的配額限制說明文件。
在 LIST 篩選器中不同欄位限制之間使用 OR 運算子

2023 年 6 月 21 日

自 2023 年 6 月 21 日起，LIST 要求 filter 參數將不再允許不同欄位之間使用 OR 邏輯運算子。

舉例來說，如要擷取含有篩選器字串 lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" 的資源，請改用含有下列篩選器字串的兩個 LIST 要求：

  • lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
  • insertionOrderId="123"

如要進一步瞭解邏輯運算子的限制，請參閱 LIST 要求篩選使用指南。

請在 2023 年 6 月 21 日前檢查所有現有 LIST 呼叫的 filter 查詢參數，確認這些呼叫正確使用 OR 邏輯運算子，以免服務中斷。
可依 budget.budget_segments.date_range.end_date 和 flight.dateRange.endDate 欄位篩選或排序清單要求

已更新初始生效日期

 2023 年 6 月 21 日

2023 年 6 月 21 日起，budget.budget_segments.date_range.end_date 和 flight.dateRange.endDate 將不再分別接受 advertisers.insertionOrders.list、advertisers.lineItems.list filter 和 orderBy 查詢參數的欄位。此日期過後，在 filter 和 orderBy 查詢參數中使用這些欄位的要求就會傳回錯誤。

請在 2023 年 6 月 21 日前，使用這兩個欄位移除所有篩選器和順序邏輯，以免服務中斷。
可依據四個額外欄位篩選 advertisers.lineItems.list 要求 2023 年 6 月 21 日

2023 年 6 月 21 日起，advertisers.lineItems.list 將不再支援使用下列欄位篩選功能：

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

請在 2023 年 6 月 21 日前，移除上述四個欄位所有的篩選器邏輯，以免服務中斷。
依據結果採購 2023 年 8 月 1 日

在 2023 年 8 月 1 日，如果廣告訂單採用依據結果採購 (由 BILLABLE_OUTCOME_PAY_PER_CLICK 或 BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION 的 billableOutcome 欄位值定義)，其下層委刊項就會封存。

這項變更會影響下列要求：