公告淘汰

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

API 的淘汰和停用日期也會在 Google Ads 開發人員網誌上公告。

版本淘汰

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

  • 發布:版本脫離 Alpha 版或 Beta 版狀態,視為穩定版。這個版本仍可能發布新功能。
  • 淘汰:該版本即將停用,並已公布支援終止 (淘汰) 日期。使用者必須在終止支援日期前遷移至新版。這個版本不會再發布新功能。
  • 停止服務:系統不再支援這個版本。對該版本提出的要求會傳回錯誤。

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

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

淘汰功能

請追蹤 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 第 1 版的 LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER 列舉值,以及 DV360 API 第 1 版的 LineItemFlight.triggerId 欄位將停用。屆時,對這些服務或欄位提出的要求都會傳回錯誤。

建議採取的行動:

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

時間表:

  • 2023 年 5 月 20 日:您將無法再將GoogleAudience資源 (GoogleAudienceTypeGOOGLE_AUDIENCE_TYPE_INSTALLED_APPSGOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES) 指派給委刊項或廣告訂單的目標對象指定目標。如果要求將這些目標對象指派給委刊項的目標對象指定,系統會傳回錯誤。如果建立的委刊項會在指定目標對象中納入已淘汰的目標對象,則包括 advertisers.lineItems.duplicateadvertisers.lineItems.generateDefault 要求。
  • 2023 年 6 月 8 日:系統會從所有委刊項和刊登訂單指定目標,以及所有合併目標對象中,移除受影響的目標對象。如果移除這些目標對象後,委刊項無法放送廣告,系統就會暫停委刊項。自該日起,也無法再使用 googleAudiences 服務擷取這些目標對象。

建議工作:

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

時間表:

  • 2023 年 5 月 20 日:您將無法再將FirstAndThirdPartyAudience資源 (AudienceTypeACTIVITY_BASEDFREQUENCY_CAP) 指派給委刊項或廣告訂單的目標對象指定目標。如果要求將這些目標對象指派給委刊項的目標對象指定,系統會傳回錯誤。如果建立的委刊項會在指定目標對象中納入已淘汰的目標對象,則包括 advertisers.lineItems.duplicateadvertisers.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 日前,檢查所有現有filterLIST呼叫的查詢參數,並確認這些參數正確使用 OR 邏輯運算子,以免服務中斷。

可依 budget.budget_segments.date_range.end_dateflight.dateRange.endDate 欄位篩選或排序清單要求

更新初始生效日期

2023 年 6 月 21 日

2023 年 6 月 21 日起,budget.budget_segments.date_range.end_dateflight.dateRange.endDate 將分別不再是 advertisers.insertionOrders.listadvertisers.lineItems.list filterorderBy 查詢參數的接受欄位。之後,在 filterorderBy 查詢參數中使用這些欄位的要求會傳回錯誤。

請在 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_CLICKBILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION),以及這些廣告訂單的子項委刊項。

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

廣告素材資源中的 publisherReviewStatuses 欄位 2024 年 6 月 26 日

自 2024 年 6 月 26 日起,publisherReviewStatuses 欄位將停用,擷取 Creative 資源時會顯示空白。

YouTube 與合作夥伴委刊項的內容指定目標 2024 年 9 月 30 日

自 2024 年 9 月 30 日起,YouTube 與合作夥伴委刊項將停止支援下列指定目標類型的值:

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

為避免服務中斷,請在淘汰日期前,從所有現有的 YouTube 與合作夥伴委刊項中移除這項指定目標。

Oracle 第一方和第三方目標對象 2024 年 9 月 30 日

2024 年 9 月 30 日,Oracle 的 FirstAndThirdPartyAudience 資源來源將停止服務。淘汰後,這些目標對象將從所有現有資源指定目標和合併目標對象中移除。如果委刊項只指定即將淘汰的目標對象,或排除任何即將淘汰的目標對象,這項更新會自動暫停該委刊項。

為避免服務中斷,請在淘汰日期前,找出並移除現有目標對象指定目標和合併目標對象中的所有 Oracle 目標對象。

部分出價策略的委刊項最佳化指定目標 2024 年 9 月 30 日

自 2024 年 9 月 30 日起,LineItem 資源若使用部分出價策略,將無法再搭配最佳化指定目標。這項變更生效後,系統會將 targetingExpansion.enableOptimizedTargeting 設為 TruebidStrategy.maximizeSpendAutoBid.performanceGoalType 設為 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVABIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TENBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED,或是 bidStrategy.performanceGoalAutoBid.performanceGoalType 設為 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPMLineItem 資源,更新為將 targetingExpansion.enableOptimizedTargeting 設為 False

為避免服務中斷,請更新並確認使用這些出價策略的委刊項未開啟最佳化指定目標對象功能。

廣告訂單的「檔期盡快」Pacing 2024 年 11 月 5 日

2024 年 11 月 5 日起,設定廣告訂單 pacing 欄位時,PACING_TYPE_ASAP 將不再與 PACING_PERIOD_FLIGHT 相容。系統會將所有現有廣告訂單的 pacingType 更新為 PACING_TYPE_AHEAD

為避免服務中斷,請使用 PACING_TYPE_ASAPPACING_PERIOD_FLIGHT 更新現有任何刊登訂單的 pacing

展示頻率上限時間範圍超過 30 天 2025 年 2 月 28 日

2025 年 2 月 28 日:

  • 建立或更新 LineItemInsertionOrderCampaign 資源的要求,如使用 FrequencyCap 物件,且 timeUnit 欄位設為 TIME_UNIT_LIFETIME,或 timeUnit 欄位設為 TIME_UNIT_MONTH,且 timeUnitCount 欄位設為 2,則會傳回 400 錯誤。
  • 如果委刊項廣告訂單廣告活動結構化資料檔案的「頻率週期」欄值為「整個生命週期」,或「頻率週期」欄值為「月」,且「頻率金額」欄值為「2」,則檔案上傳後將無法建立或更新項目。
  • 現有廣告活動、廣告訂單和委刊項的展示頻率上限週期將更新為 30 天以內。

為避免服務中斷:

  • 請將使用超過 30 天展示頻率上限週期的現有廣告活動、廣告訂單和委刊項資源,更新為 30 天或更短。
  • 使用 Display & Video 360 API 或結構化資料檔案建立或更新廣告活動、廣告訂單或委刊項資源時,請確認整合功能未將展示頻率上限週期設為超過 30 天。
使用固定出價的委刊項最佳化指定目標對象 2025 年 3 月 6 日

2025 年 3 月 6 日:

  • 建立或更新 LineItem 資源,將 BiddingStrategy 欄位 fixedBidTargetingExpansionConfig 欄位 enableOptimizedTargeting 設為 true 的要求,會傳回 400 錯誤。
  • 如果委刊項結構化資料檔案中,「出價策略類型」欄的值為「固定」,且「已最佳化目標對象」欄的值為「True」,則上傳檔案時,系統將無法建立或更新項目。
  • 使用固定出價的現有委刊項將更新,以關閉最佳化指定目標。

為避免服務中斷:

  • 更新同時使用固定出價和最佳化指定目標的現有委刊項資源。
  • 使用 Display & Video 360 API 或結構化資料檔案建立或更新委刊項資源時,請確認整合功能未設定固定出價策略和最佳化目標對象。
更新為firstAndThirdPartyAudiences.list預設頁面大小 2025 年 3 月 6 日

自 2025 年 3 月 6 日起,firstAndThirdPartyAudiences.list 要求的預設頁面大小將從 100 更新為 5000。

為避免服務中斷,請更新整合,將 firstAndThirdPartyAudiences.list 要求的 pageSize 查詢參數設為偏好的頁面大小。

新的 sdfdownloadtasks.create 合作夥伴/廣告主不符錯誤 2025 年 3 月 6 日

2025 年 3 月 6 日起,如果 sdfdownloadtasks.create 要求使用父項實體篩選器,依據非該組 partnerId 的子項廣告主進行篩選,就會開始傳回 400 錯誤。

結構化資料檔案中的 YouTube 觸及率委刊項限制 2025 年 3 月 24 日

自 2025 年 3 月 24 日起,使用結構化資料檔案建立或更新委刊項時,必須使用更廣泛的廣告格式。也就是遵守下列規範:

  • SDF v6v7 不再支援使用 Subtype 值「觸及」建立新的委刊項檔案項目。
  • 在結構化資料檔案的委刊項檔案中,如果新項目的 Subtype 值為「觸及」,則 TrueView Video Ad Formats 欄必須使用「多媒體」值。如果現有項目的「Subtype」值為「觸及」,則無法更新「TrueView Video Ad Formats」資料欄值。
  • 如果結構化資料檔案委刊項的新項目含有 Subtype 值「觸及」,則必須填入 TrueView Video Ad Inventory Control 欄。
自訂出價演算法與 Floodlight 活動不符 2025 年 4 月 1 日

2025 年 4 月 1 日:

為避免服務中斷,請將整合功能更新為:

  • 請先將相關的 Floodlight 活動指派給委刊項,再指派自訂出價演算法,或同時進行這兩項作業。
  • 更新前,系統會先從所有委刊項取消指派現有的自訂出價演算法。

第一方目標對象的成員資格效期無限 2025 年 4 月 7 日

自 2025 年 4 月 7 日起,FirstAndThirdPartyAudience 資源將不再允許無限期目標對象成員資格。如果 firstAndThirdPartyAudiences.createfirstAndThirdPartyAudiences.patch 要求將 membershipDurationDays 欄位值設為 10,000,系統會傳回 400 錯誤。membershipDurationDays 欄位值為 10,000 的現有目標對象將更新為 540,且新的會籍期限將追溯套用至現有會籍。系統會將所有超過 540 天的成員資格設為無效。

為避免服務中斷:

在第 4 版中,這項變更會反映在 FirstPartyAndPartnerAudience 資源中。

結構化資料檔案中的影片行動廣告活動 2025 年 4 月 22 日

2025 年 4 月 22 日起,您將無法再使用結構化資料檔案,為影片行動廣告活動建立委刊項,因為這類廣告活動將升級為需求開發廣告活動。如果嘗試上傳的委刊項項目,其 Subtype 欄值為「Action」,且 Type 欄值為「TrueView」,系統就會顯示錯誤訊息。

為避免服務中斷,請更新整合,改用需求開發廣告活動,而非影片行動廣告活動。

結構化資料檔案中的需求開發委刊項必須提供影片合作夥伴廣告空間來源 2025 年 4 月 22 日

自 2025 年 4 月 22 日起,如果Type 欄的值為「需求開發」,則委刊項項目的 TrueView Inventory Source Targeting 欄必須包含「影片合作夥伴」值。這項強制措施生效後,系統會為現有委刊項回填值,並在下載新的結構化資料檔案時一併提供。

為避免服務中斷:

  • 更新整合功能,在所有需求開發委刊項項目中加入「影片合作夥伴」值。
  • 更新整合功能,使用 SDF v8.1 廣告群組Demand Gen Inventory Source StrategyDemand Gen Enabled Inventory Sources,在廣告群組層級管理需求開發廣告空間來源。
明細項目結構化資料檔案中的「出價乘數」欄 2025 年 5 月 1 日

自 2025 年 5 月 1 日起,如果委刊項結構化資料檔案中的項目嘗試設定「出價調節係數」欄,系統將無法在檔案上傳時建立或更新資源。

YouTube 與合作夥伴委刊項的內容類別設定 2025 年 6 月 12 日

為更新品牌合適度體驗,自 2025 年 6 月 12 日起,您將無法再修改個別 YouTube 與合作夥伴委刊項的內容類別設定。內容類別設定將改為僅在廣告主層級控管。為配合這項異動,Display & Video 360 API 和結構化資料檔案將進行以下變更:

為避免服務中斷,請採取下列行動:
透過廣告訂單最佳化功能更新委刊項預算 2025 年 6 月 12 日

自 2025 年 6 月 12 日起,如果父項廣告訂單已設為使用自動出價策略進行最佳化,您就無法再更新委刊項的預算設定。

為避免服務中斷,請採取下列行動:
結構化資料檔案的網站限制 2025 年 6 月 12 日

自 2025 年 6 月 12 日起,我們將移除結構化資料檔案 (SDF) 項目中網址的現有限制,不再排除較新的網站。SDF 會比照 API 和使用者介面行為,只要網址格式正確,就能指定網址。

這與「廣告訂單」和「委刊項」檔案中的 Site Targeting - IncludeSite Targeting - Exclude 欄相關。
聲明委刊項是否放送歐盟政治廣告 2025 年 9 月 8 日

自 2025 年 9 月 8 日起,使用 Display & Video 360 API 或 SDF 建立新委刊項時,必須聲明委刊項是否會放送歐盟政治廣告。您可以透過下列方式進行聲明:

如果上層廣告主不會包含任何放送歐盟政治廣告的委刊項,您可以使用 Display & Video 360 API Advertiser 資源中的 containsEuPoliticalAds 欄位,在廣告主層級進行聲明。如果這個欄位設為 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING,廣告主底下的所有新委刊項都會指派相同的值 (除非另有指定),廣告主底下的所有現有委刊項也會更新為使用相同的值 (如果尚未設定值)。建立委刊項後,隨時可以透過使用者介面、API 或結構化資料檔案更新聲明。

如果您無法在廣告主層級聲明,或已聲明廣告主可能會放送歐盟政治廣告,請在 2025 年 9 月 8 日前更新 Display & Video 360 API 和 SDF 整合,以免服務中斷:

在 Display & Video 360 API 和結構化資料檔案中管理廣告訂單和廣告活動指定目標 2026 年 2 月

Display & Video 360 將於 2026 年 2 月淘汰廣告訂單和廣告活動指定目標。為配合這項異動,Display & Video 360 API 和結構化資料檔案 (SDF) 也會進行變更。在 Display & Video 360 API 中,部分方法將會停用,如果呼叫這些方法,系統會傳回錯誤。在 SDF 中,下載「插入單」和「廣告活動」檔案時,系統不會再填入指定目標資料欄,上傳時也必須為空白。建議使用者在建立委刊項時,直接為委刊項指派指定目標。

呼叫下列 Display & Video 360 API 方法時,會傳回 404 錯誤:

如果廣告活動結構化資料檔案項目在下列資料欄中已指派值,上傳時就會失敗:

  • Demographic Targeting Gender
  • Demographic Targeting Age
  • Demographic Targeting Household Income
  • Demographic Targeting Parental Status
  • Geography Targeting - Include
  • Geography Targeting - Exclude
  • Language Targeting - Include
  • Language Targeting - Exclude
  • Digital Content Labels - Exclude
  • Brand Safety Sensitivity Setting
  • Brand Safety Custom Settings
  • Third Party Verification Services
  • Third Party Verification Labels
  • Viewability Targeting Active View
  • Position Targeting - Display On Screen
  • Position Targeting - Video On Screen
  • Position Targeting - Display Position In Content
  • Position Targeting - Video Position In Content
  • Inventory Source Targeting - Authorized Seller Options
  • Inventory Source Targeting - Include
  • Inventory Source Targeting - Exclude
  • Inventory Source Targeting - Target New Exchanges
  • Environment Targeting

如果插入單結構化資料檔案項目在下列欄位中含有指派的值,上傳時就會失敗:

  • Geography Targeting - Include
  • Geography Targeting - Exclude
  • Proximity Targeting
  • Proximity Location List Targeting
  • Language Targeting - Include
  • Language Targeting - Exclude
  • Device Targeting - Include
  • Device Targeting - Exclude
  • Browser Targeting - Include
  • Browser Targeting - Exclude
  • Digital Content Labels - Exclude
  • Brand Safety Sensitivity Setting
  • Brand Safety Custom Settings
  • Third Party Verification Services
  • Third Party Verification Labels
  • Channel Targeting - Include
  • Channel Targeting - Exclude
  • Site Targeting - Include
  • Site Targeting - Exclude
  • App Targeting - Include
  • App Targeting - Exclude
  • App Collection Targeting - Include
  • App Collection Targeting - Exclude
  • Category Targeting - Include
  • Category Targeting - Exclude
  • Content Genre Targeting - Include
  • Content Genre Targeting - Exclude
  • Keyword Targeting - Include
  • Keyword Targeting - Exclude
  • Keyword List Targeting - Exclude
  • Audience Targeting - Include
  • Audience Targeting - Exclude
  • Affinity & In Market Targeting - Include
  • Affinity & In Market Targeting - Exclude
  • Custom List Targeting
  • Inventory Source Targeting - Authorized Seller Options
  • Inventory Source Targeting - Include
  • Inventory Source Targeting - Exclude
  • Inventory Source Targeting - Target New Exchanges
  • Daypart Targeting
  • Daypart Targeting Time Zone
  • Environment Targeting
  • Viewability Omid Targeting Enabled
  • Viewability Targeting Active View
  • Position Targeting - Display On Screen
  • Position Targeting - Video On Screen
  • Position Targeting - Display Position In Content
  • Position Targeting - Video Position In Content
  • Position Targeting - Audio Position In Content
  • Video Player Size Targeting
  • Content Duration Targeting
  • Content Stream Type Targeting
  • Audio Content Type Targeting
  • Demographic Targeting Gender
  • Demographic Targeting Age
  • Demographic Targeting Household Income
  • Demographic Targeting Parental Status
  • Connection Speed Targeting
  • Carrier Targeting - Include
  • Carrier Targeting - Exclude

我們會在日後更新這篇文章,提供確切日期。