公告淘汰

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

我們也會在 Google Ads 開發人員網誌上宣布 API 的淘汰和停用日期。

版本淘汰

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

  • 發布版本：版本已退出任何 Alpha 或 Beta 狀態，並視為穩定版本。但仍可能為該版本發布新增功能。
  • 淘汰：這個版本即將退役，且已宣布服務終止日期。使用者必須在停用日期前遷移至新版。我們不會再為該版本發布新增功能。
  • 已淘汰：我們不再支援這個版本。對該版本提出的要求會傳回錯誤。

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

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

淘汰功能

請密切留意 Google Ads 開發人員網誌，掌握即將淘汰的重要功能。

下表列出所有已宣布的功能淘汰作業，並提供初始生效日期和淘汰作業說明，以及建議的操作和相關文件的連結：

功能 初始生效日期 說明
擴展指定目標 2023 年 3 月 25 日 從 2023 年 3 月 25 日開始，我們會逐步取代擴展指定目標功能，改用最佳化指定目標對象功能。我們已在部落格文章中宣布 Display & Video 360 API 和結構化資料檔案行為的相關異動，並提供建議的行動。
手動觸發條件 2023 年 5 月 17 日

時間表：

  • 2023 年 5 月 17 日：使用手動觸發條件的委刊項將停止在 Display & Video 360 中放送。如果您在該日期之後啟用與有效委刊項相關聯的手動觸發條件，委刊項就不會放送廣告。
  • 2023 年 8 月 1 日：DV360 API v1 和 v2 中的 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 日：您將無法再將 FirstAndThirdPartyAudience 資源指派給委刊項或廣告訂單目標對象，且 AudienceType 為 ACTIVITY_BASED 或 FREQUENCY_CAP。將這些目標對象指派給委刊項的目標對象指定項目時，要求會傳回錯誤。這包括 advertisers.lineItems.duplicate 和 advertisers.lineItems.generateDefault 要求，如果建立的委刊項會在指定目標對象時納入即將淘汰的目標對象。
  • 2023 年 6 月 8 日：系統會從所有委刊項和廣告訂單指定目標，以及所有合併目標對象中移除受影響的目標對象。如果委刊項在移除這些目標對象後無法放送廣告，就會暫停放送。自該日起，您也無法再使用 firstAndThirdPartyAudiences 服務擷取這些目標對象。

建議的工作：

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

自 2023 年 5 月 30 日起，現有的用量限制將改為混合配額結構，可執行下列操作：

  1. 取消每項專案每天要求配額。
  2. 針對符合資格的廣告客戶，為每個專案建立每分鐘的廣告客戶要求配額。

這些新限制可讓您更靈活地使用 API，並在廣告客戶之間並行處理請求。如要進一步瞭解這項異動，請參閱現有的配額限制說明文件。
OR 運算子在 LIST 篩選器中不同欄位限制之間的使用方式

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 日，系統會封存使用依據結果設定採購的廣告訂單，這些廣告訂單的 billableOutcome 欄位值為 BILLABLE_OUTCOME_PAY_PER_CLICK 或 BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION，以及相關的子委刊項。

這項變更會影響下列要求：
廣告素材資源中的 publisherReviewStatuses 欄位 2024 年 6 月 26 日

自 2024 年 6 月 26 日起，publisherReviewStatuses 欄位將停用，擷取 Creative 資源時會顯示為空白。
YouTube 與合作夥伴委刊項的內容指定目標 2024 年 9 月 30 日

自 2024 年 9 月 30 日起，下列指定指定目標類型的值將不再支援 YouTube 與合作夥伴委刊項：

系統會自動從現有委刊項指定目標中移除 Sunset 指定目標選項。這些值仍可用於廣告客戶層級指定目標。

為避免服務中斷，請在停用日期前，從現有的 YouTube 與合作夥伴委刊項中移除這項指定目標。
Oracle 第一方和第三方目標對象 2024 年 9 月 30 日

2024 年 9 月 30 日，Oracle 的 FirstAndThirdPartyAudience 資源來源將停止服務。停用後，系統會從現有資源指定和合併目標對象中移除這些目標對象。如果委刊項只指定淘汰的目標對象，或是以負向方式指定任何淘汰的目標對象，這項更新會自動暫停該委刊項。

為避免服務中斷，請在停用日期前，從現有廣告項目目標對象和合併目標對象中找出並移除任何 Oracle 目標對象。
委刊項最佳化指定目標對象 (適用於部分出價策略) 2024 年 9 月 30 日

自 2024 年 9 月 30 日起，採用部分出價策略的 LineItem 資源將無法再搭配最佳化指定目標對象使用。這項變更後，LineItem資源的 targetingExpansion.enableOptimizedTargeting 會設為 True，bidStrategy.maximizeSpendAutoBid.performanceGoalType 則設為 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA、BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN 或 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED，bidStrategy.performanceGoalAutoBid.performanceGoalType 則設為 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM。targetingExpansion.enableOptimizedTargetingFalse

為避免服務中斷，請更新並確認使用這些出價策略的委刊項未開啟最佳化指定目標對象功能。
廣告訂單的「檔期盡快」Pacing 2024 年 11 月 5 日

自 2024 年 11 月 5 日起，PACING_TYPE_ASAP 在設定廣告訂單 pacing 欄位時，將不再與 PACING_PERIOD_FLIGHT 相容。所有採用這項設定的現有廣告訂單，其 pacingType 都會更新為 PACING_TYPE_AHEAD。

為避免服務中斷，請使用 PACING_TYPE_ASAP 和 PACING_PERIOD_FLIGHT 更新現有廣告訂單的 pacing。
第一方目標對象的無限會員期限 2025 年 4 月 7 日

自 2025 年 4 月 7 日起，FirstAndThirdPartyAudience 資源將不再允許無限的目標對象會員期限。firstAndThirdPartyAudiences.create 和 firstAndThirdPartyAudiences.patch 要求將 membershipDurationDays 欄位值設為 10,000 時，會傳回 400 錯誤。membershipDurationDays 欄位值為 10,000 的現有目標對象會更新為 540，新的會員期限也會向前套用至現有會員資格。這麼做會讓所有超過 540 天的會員資格失效。

為避免服務中斷，請採取下列行動：