Display & Video 360 API 現在支援管理需求開發資源。請參閱
這份新指南 ,瞭解如何建立及放送需求開發廣告活動。
Google 會運用 AI 技術將內容翻譯成你偏好的語言,但可能會出錯。
提供意見
公告淘汰
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
本頁列出 Display & Video 360 API 中 API 版本 和個別功能 的淘汰和停用日期。
API 的淘汰和停用日期也會在 Google Ads 開發人員網誌 上公布。
版本淘汰
Display & Video 360 API 版本會定期發布、淘汰及停用。這些步驟的定義如下:
發布 :版本退出 Alpha 版或 Beta 版狀態,並視為穩定版。該版本可能仍會推出新功能。
淘汰 :版本即將停用,並宣布終止支援 (停用) 日期。使用者必須在停用日期前遷移至新版本。我們不會再為這個版本推出新功能。
終止服務 :不再支援該版本。對該版本提出的要求會傳回錯誤。
這個表格列出所有現有的核心 Display & Video 360 API 版本、推出日期,以及淘汰和停用日期 (如有公布)。
淘汰功能
請追蹤 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 和結構化資料檔案將做出以下調整:
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 淘汰版本的影響,請參閱已封存的淘汰計畫 。
提供意見
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權 ,程式碼範例則為阿帕契 2.0 授權 。詳情請參閱《Google Developers 網站政策 》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2026-11-13 (世界標準時間)。
想進一步說明嗎?
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2026-11-13 (世界標準時間)。"],[],[]]