公告淘汰

本頁列出 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 日 從第 3 版遷移至第 4 版
v2 2022 年 12 月 6 日 2024 年 2 月 15 日 2024 年 9 月 3 日 從第 2 版遷移至第 3 版
v1 2020 年 3 月 9 日 2023 年 3 月 13 日 2023 年 9 月 14 日 從第 1 版遷移至第 2 版

淘汰功能

請追蹤 Google Ads 開發人員網誌,掌握即將淘汰的重要功能。

下表列出所有已宣布淘汰、會影響現行版本的功能,並提供最初生效日期、淘汰說明、應變措施建議,以及相關說明文件的連結:

功能 初始生效日期 說明
YouTube 回應式廣告必須提供商家名稱和標誌值

初始生效日期已更新

2027 年 1 月

2027 年 1 月起,如果廣告主未設定預設值,YouTube 回應式廣告必須提供商家名稱和標誌素材資源。

因此,如果未將預設值指派給上層廣告主,則必須為「回應式」類型的廣告設定廣告 SDF 中的 Business Name 和 Logo Asset IDs 欄。如果已指派預設值,且資料欄留空,廣告在儲存時會沿用廣告主層級的預設值。

敏感類別排除功能即將停用 2026 年 10 月 1 日

2026 年 10 月 1 日起,指定委刊項指定目標時,將無法再排除大多數敏感類別。為因應這項異動,Display & Video 360 API 和結構化資料檔案將做出以下調整:

  • 下列 SensitiveCategory 列舉值將淘汰,且在指派 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION 類型的指定目標時,SensitiveCategoryAssignedTargetingOptionDetails 物件的 excludedSensitiveCategory 欄位將不再接受這些值:
    • SENSITIVE_CATEGORY_ADULT
    • SENSITIVE_CATEGORY_ALCOHOL
    • SENSITIVE_CATEGORY_DEROGATORY
    • SENSITIVE_CATEGORY_DOWNLOADS_SHARING
    • SENSITIVE_CATEGORY_DRUGS
    • SENSITIVE_CATEGORY_GAMBLING
    • SENSITIVE_CATEGORY_POLITICS
    • SENSITIVE_CATEGORY_PROFANITY
    • SENSITIVE_CATEGORY_RELIGION
    • SENSITIVE_CATEGORY_SENSITIVE_SOCIAL_ISSUES
    • SENSITIVE_CATEGORY_SHOCKING
    • SENSITIVE_CATEGORY_SUGGESTIVE
    • SENSITIVE_CATEGORY_TOBACCO
    • SENSITIVE_CATEGORY_TRAGEDY
    • SENSITIVE_CATEGORY_TRANSPORTATION_ACCIDENTS
    • SENSITIVE_CATEGORY_VIOLENCE
    • SENSITIVE_CATEGORY_WEAPONS
  • 委刊項 SDF 的 Brand Safety Sensitivity Setting 欄將不再允許「使用自訂」選項。
  • 系統將不再支援委刊項 SDF 中的 Brand Safety Custom Settings 欄,並會在下載時填入空白值。
數位內容標籤排除條件即將停用 2026 年 10 月 1 日

2026 年 10 月 1 日起,您將無法再使用指定目標排除特定數位內容標籤。為因應這項異動,Display & Video 360 API 和結構化資料檔案將做出以下調整:

  • 下列 ContentRatingTier 列舉值將淘汰,且在指派 TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION 類型的指定目標時,DigitalContentLabelAssignedTargetingOptionDetails 物件的 excludedContentRatingTier 欄位將不再接受這些值:
    • CONTENT_RATING_TIER_FAMILIES
    • CONTENT_RATING_TIER_GENERAL
    • CONTENT_RATING_TIER_MATURE
    • CONTENT_RATING_TIER_PARENTAL_GUIDANCE
    • CONTENT_RATING_TIER_TEENS
    • CONTENT_RATING_TIER_UNSPECIFIED
  • 委刊項 SDF 的 Digital Content Labels - Exclude 欄只能指派「?」選項,否則該欄必須留空。如果嘗試指派任何其他值,上傳時會發生錯誤。
Nielsen 做為第三方供應商評估品牌提升 2026 年 7 月 13 日

2026 年 7 月 13 日起,Nielsen 將無法再指派為評估品牌提升的第三方供應商。為因應這項異動,Display & Video 360 API 和結構化資料檔案將做出以下調整:

系統將移除現有的 Nielsen 品牌提升供應商。

為避免服務中斷,請從整合中移除任何將 Nielsen 指定為品牌提升供應商的設定。

沿用預設商家名稱和標誌 2026 年 7 月 13 日

2026 年 7 月 13 日起,YouTube 回應式廣告將開始支援商家名稱和標誌素材資源,所有未設定商家名稱和標誌素材資源的需求開發和 YouTube 回應式廣告,都會沿用廣告主層級設定的預設值。同時,這項異動也會導致 Display & Video 360 API 和結構化資料檔案的行為發生以下變化:

  • 如果父項廣告主已指派預設值,則 ad_details 需求開發 AdGroupAd 資源中的 businessName、logo 和 logoImages 欄位將不再是必填欄位。如未提供,廣告會沿用廣告主層級的預設值。
  • 廣告 SDF 中的 Business Name 和 Logo Asset IDs 欄,可為下列任一類型的廣告設定:「回應式」、「需求開發產品」、「需求開發影片」、「需求開發圖片」和「需求開發輪轉」。如果未針對相關廣告項目設定這些資料欄,且上層廣告主已指派預設值,則廣告在儲存後會沿用廣告主層級的預設值。
  • 如果需求開發廣告的上層廣告主已指派預設值,則廣告 SDF 中的 Business Name 和 Logo Asset IDs 欄就不再是必填欄位。

如果在廣告主層級設定預設值,該廣告主的所有廣告都會有指定的商家名稱和標誌值。如要讓 YouTube 回應式廣告的商家名稱和標誌素材資源值保持未設定狀態,請不要為廣告主設定預設值。

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

2026 年 2 月 23 日,Display & Video 360 將停用廣告訂單和廣告活動指定目標。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

如果廣告訂單 SDF 項目在下列資料欄中指派了值,上傳時就會失敗:

  • 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
聲明委刊項是否放送歐盟政治廣告 2025 年 9 月 8 日

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

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

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

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 項目中指定網址的現有限制,不再限制納入較新的網站。而是會比照 API 和使用者介面的行為,只要網址格式正確,就能指定。

這與廣告訂單和委刊項檔案中的 Site Targeting - Include 和 Site Targeting - Exclude 欄有關。
明細項目結構化資料檔案中的「出價調節係數」欄 2025 年 5 月 1 日

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

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

自 2025 年 4 月 22 日起,如果委刊項項目的 Type 欄值為「需求開發」,則必須在 TrueView Inventory Source Targeting 欄中加入「影片合作夥伴」值。這項規定生效後,系統會為現有委刊項回填這個值,並在下載新的結構化資料檔案時納入這個值。

為避免服務中斷,請採取下列行動:

  • 更新整合功能,在所有需求開發委刊項項目中加入「影片合作夥伴」值。
  • 請更新整合項目,使用 SDF 第 8.1 版廣告群組欄 Demand Gen Inventory Source Strategy 和 Demand Gen Enabled Inventory Sources,在廣告群組層級管理需求開發廣告空間來源。
結構化資料檔案中的影片行動廣告活動 2025 年 4 月 22 日

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

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

第一方目標對象的再行銷效期無限 2025 年 4 月 7 日

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

為避免服務中斷,請採取下列行動:

在第 4 版中,這項異動會反映在 FirstPartyAndPartnerAudience 資源中。

自訂出價演算法和 Floodlight 活動不相符 2025 年 4 月 1 日

2025 年 4 月 1 日:

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

  • 請確認相關 Floodlight 活動已指派給委刊項,且指派時間不晚於自訂出價演算法。
  • 現有的自訂出價演算法會先從所有委刊項中取消指派,然後才嘗試更新。

先前淘汰的功能

如要瞭解已宣布的淘汰計畫對 Display & Video 360 API 淘汰版本的影響,請參閱已封存的淘汰計畫。