公告淘汰

本頁列出 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 開發人員網誌，瞭解即將淘汰的重要功能。

下表列出所有已公布的淘汰功能，這些功能會影響即時版本，並提供初始生效日期、淘汰說明、建議動作，以及相關文件的連結：

功能	初始生效日期	說明
在 Display & Video 360 API 和結構化資料檔案中管理廣告訂單和廣告活動指定目標	2026 年 2 月 23 日	Display & Video 360 將於 2026 年 2 月 23 日淘汰廣告訂單和廣告活動指定目標。為配合這項異動，Display & Video 360 API 和結構化資料檔案 (SDF) 也會進行變更。在 Display & Video 360 API 中，部分方法將會停用，如果呼叫這些方法，系統會傳回錯誤。在 SDF 中，下載「廣告訂單」和「廣告活動」檔案時，系統不會再填入指定目標資料欄，上傳時也必須留空。建議使用者在建立委刊項時，直接為委刊項指派指定目標。 如果呼叫下列 Display & Video 360 API 方法，系統會傳回 404 錯誤： advertisers.campaigns.listAssignedTargetingOptions advertisers.campaigns.targetingTypes.assignedTargetingOptions.get advertisers.campaigns.targetingTypes.assignedTargetingOptions.list advertisers.insertionOrders.listAssignedTargetingOptions advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.create advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.delete advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.get advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list advertisers.lineItems.generateDefault 如果廣告活動結構化資料檔案項目在下列資料欄中已指派值，上傳時就會失敗： 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
聲明委刊項是否放送歐盟政治廣告	2025 年 9 月 8 日	自 2025 年 9 月 8 日起，使用 Display & Video 360 API 或 SDF 建立新委刊項時，您必須聲明委刊項是否會放送歐盟政治廣告。您可以透過下列方式聲明： 使用 Display & Video 360 API LineItem 資源中的 containsEuPoliticalAds 欄位。您也可以使用 advertisers.lineItems.duplicate 和 advertisers.lineItems.generateDefault 要求中的新欄位進行這項聲明。 在結構化資料第 9 版的委刊項檔案類型中使用 Contains EU Political Ads 資料欄。 如果上層廣告主不會包含任何放送歐盟政治廣告的委刊項，您可以使用 Display & Video 360 API Advertiser 資源中的 containsEuPoliticalAds 欄位，在廣告主層級進行聲明。如果這個欄位設為 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING，則廣告主下的所有新委刊項都會指派相同的值 (除非另有指定)，且廣告主下的所有現有委刊項都會更新為使用相同的值 (如果尚未設定值)。建立委刊項後，隨時可以透過使用者介面、API 或結構化資料檔案更新聲明。 如果您無法在廣告主層級聲明，或已聲明廣告主可能會放送歐盟政治廣告，請在 2025 年 9 月 8 日前更新 Display & Video 360 API 和 SDF 整合，以免服務中斷： 提出 advertisers.lineItems.create 要求時，請在新 LineItem 資源中設定 containsEuPoliticalAds 欄位。 在任何 advertisers.lineItems.duplicate 和 advertisers.lineItems.generateDefault 要求的請求主體中，設定 containsEuPoliticalAds 欄位。 遷移至結構化資料檔案第 9 版，並在上傳時，將任何新委刊項的 Contains EU Political Ads 欄設為 Yes 或 No。如需逐步操作說明，請參閱 v9 遷移指南。 使用 Display & Video 360 API 或 SDF 更新現有委刊項的指定地理區域前，請先更新委刊項以提供聲明。
YouTube 與合作夥伴委刊項的內容類別設定	2025 年 6 月 12 日	為更新品牌合適度體驗，自 2025 年 6 月 12 日起，您將無法再修改個別 YouTube 與合作夥伴委刊項的內容類別設定。內容類別設定將改為僅在廣告主層級控管。為配合這項異動，Display & Video 360 API 和結構化資料檔案將進行以下變更： YouTube 與合作夥伴 LineItem 資源的 YoutubeAndPartnersSettings 物件中，contentCategory 欄位將不再更新。並於日後完全移除。 委刊項 SDF 中的「TrueView Content Filter」欄位將無法再寫入。 為避免服務中斷，請採取下列行動： 在 API 中查看 YouTube 與合作夥伴委刊項時，請改為擷取 effectiveContentCategory 欄位，而非 contentCategory 欄位。 更新結構化資料檔案委刊項項目時，請停止修改 TrueView Content Filter 欄。建立新委刊項時，請將這個資料欄留空。
透過廣告訂單最佳化功能更新委刊項預算	2025 年 6 月 12 日	自 2025 年 6 月 12 日起，如果父項廣告訂單已設為使用自動出價策略進行最佳化，您就無法再更新委刊項的預算設定。 為避免服務中斷，請採取下列行動： 在 API 中：檢查委刊項的父項 InsertionOrder 是否已設定 bidStrategy.maximizeSpendAutoBid 或 bidStrategy.performanceGoalAutoBid。如果是，請勿嘗試使用 advertisers.lineItems.patch 更新 LineItem 預算欄位。 在結構化資料檔案中：檢查委刊項父項廣告訂單的結構化資料檔案項目，確認 Insertion Order Optimization 欄是否設為 TRUE。如果是，請勿嘗試更新委刊項 SDF 項目中的 Budget Type 或 Budget Amount 欄。
結構化資料檔案的網站限制	2025 年 6 月 12 日	自 2025 年 6 月 12 日起，我們將移除 SDF 項目中指定網址的現有限制，不再排除較新的網站。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 v8.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 天的成員資格設為無效。 為避免服務中斷： 確認整合功能未將新或現有目標對象的 membershipDurationDays 欄位值設為 10,000。 使用 firstAndThirdPartyAudiences.editCustomerMatchMembers 重新整理現有目標顧客比對目標對象的成員資格。 定期更新目標顧客比對目標對象的成員資格，確保目標對象名單大小不會無意間縮小。 在第 4 版中，這項變更會反映在 FirstPartyAndPartnerAudience 資源中。
自訂出價演算法與 Floodlight 活動不符	2025 年 4 月 1 日	2025 年 4 月 1 日： 嘗試設定 ConversionCountingConfig 物件的 floodlightActivityConfigs 欄位，以及不使用相符 Floodlight 活動的 MaximizeSpendBidStrategy 或 PerformanceGoalBidStrategy 物件的 customBiddingAlgorithmId 欄位時，advertisers.lineItems.create 要求會傳回 400 錯誤。 如果 MaximizeSpendBidStrategy 或 PerformanceGoalBidStrategy 物件的 customBiddingAlgorithmId 欄位已設定，嘗試更新 ConversionCountingConfig 物件的 floodlightActivityConfigs 欄位時，advertisers.lineItems.patch 要求會傳回 400 錯誤。 如果「演算法 ID」欄位已設定，則嘗試更新「轉換 Floodlight 活動 ID」欄位的委刊項結構化資料檔案項目，將無法在檔案上傳時更新。 如果為指派給委刊項的 CustomBiddingAlgorithm 資源提出 customBiddingAlgorithms.patch、customBiddingAlgorithms.rules.create、customBiddingAlgorithms.scripts.create 要求，系統會傳回錯誤。 為避免服務中斷，請將整合服務更新為： 請先將相關 Floodlight 活動指派給委刊項，再指派自訂出價演算法，或同時進行這兩項作業。 更新前，系統會先從所有委刊項取消指派現有的自訂出價演算法。

先前淘汰的功能

如要瞭解影響 Display & Video 360 API 淘汰版本的已公布淘汰項目，請參閱已封存的淘汰項目。