公告淘汰

本頁面列出 API 的淘汰與停用日期 版本和個別功能 多媒體和Video 360 API。

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

淘汰版本

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

• 發布：這個版本會結束 Alpha 或 Beta 版的任何狀態，接著才會符合資格 以及穩定的品質系統可能仍會針對該版本發布功能新增。
• 淘汰：該版本已淘汰，並停止支援 (停用) 公告日期。使用者必須在服務終止前遷移至新版服務 日期。系統將不會再針對該版本發布新增的功能。
• 停用：不再支援這個版本。對該版本發出的要求 傳回錯誤。

下表列出所有現有的核心多媒體和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 日至 2023 年 5 月初陸續推出。多媒體和我們已在網誌文章中公告 Video 360 API 和結構化資料檔案的行為，以及建議採取的行動。
手動觸發條件	2023 年 5 月 17 日	時間表： 2023 年 5 月 17 日：使用手動觸發條件的委刊項將停止在 Display &Video 360 中放送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 欄位。在此日期之後，對這些服務或這些欄位發出的要求都會傳回錯誤。 建議採取的行動： 立即停止使用手動觸發條件來開始及停止放送委刊項。 停止向 advertisers.manualTriggers 服務發出要求。 針對使用手動觸發條件的所有委刊項更新 flight.flightDateType 和 flight.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 日：您將無法再指派 AudienceType 為 ACTIVITY_BASED 或 FREQUENCY_CAP 的 FirstAndThirdPartyAudience 資源，指派給委刊項或廣告訂單指定目標對象。要求將這些目標對象指派給委刊項指定目標對象時，將傳回錯誤。如果建立的委刊項會在指定目標對像中加入已淘汰的目標對象，這包括 advertisers.lineItems.duplicate 和 advertisers.lineItems.generateDefault 請求。 2023 年 6 月 8 日：受影響的目標對象將從所有委刊項和廣告訂單指定目標以及所有合併目標對像中移除。如果這些目標對象遭到移除，導致委刊項無法放送廣告，系統會將其暫停。自該日起，他們無法再使用 firstAndThirdPartyAudiences 服務擷取這些目標對象。 建議工作： 我們建議您在日後更新委刊項指定目標時，立即停止使用受影響的目標對象。 從現有委刊項和廣告訂單指定目標中移除所有受影響的目標對象。如要瞭解如何更新指定目標對象，請參閱目標對象指南。
現有 API 配額限制	2023 年 5 月 30 日	2023 年 5 月 30 日起，現有的用量限制將替換為混合配額，同時達成以下目標： 消除每項專案配額的每日要求數量。 為符合資格的方法建立每個專案每個專案的每分鐘要求數。 這些新限制可提高 API 使用方式的彈性，同時支援多個廣告客戶的請求。如要進一步瞭解這項異動，請參閱現有的配額限制說明文件。
在 LIST 篩選器中，不同欄位的限制之間使用 OR 運算子 生效日期	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 日起，advertisers.insertionOrders.list 和 advertisers.lineItems.list filter 和 orderBy 查詢參數中不再分別接受 budget.budget_segments.date_range.end_date 和 flight.dateRange.endDate 欄位。在此日期之後，如果在 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 定義) 將封存其下層委刊項。 這項變更會影響下列要求： 如果嘗試使用「advertisers.insertionOrders.create」透過依據結果採購建立廣告訂單，系統會傳回 400 錯誤 如果嘗試使用 advertisers.lineItems.create、advertisers.lineItems.duplicate 或 advertisers.lineItems.generateDefault 在廣告訂單中使用依據結果採購功能建立委刊項，系統會傳回 400 錯誤 由於 LIST 要求預設不會包含封存的資源，因此根據預設，advertisers.insertionOrders.list 和 advertisers.lineItems.list 方法將不再傳回受影響的資源。
廣告素材資源中的 publisherReviewStatuses 欄位	2024 年 6 月 26 日	自 2024 年 6 月 26 日起，publisherReviewStatuses 欄位將會停用，並在擷取 Creative 資源時呈現空白。
YouTube 和合作夥伴委刊項	2024 年 9 月 30 日	2024 年 9 月 30 日，針對 指定類型將停用 YouTube 和合作夥伴委刊項： TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION: CONTENT_RATING_TIER_UNRATED CONTENT_RATING_TIER_GENERAL CONTENT_RATING_TIER_PARENTAL_GUIDANCE CONTENT_RATING_TIER_TEENS CONTENT_RATING_TIER_MATURE TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION: SENSITIVE_CATEGORY_EMBEDDED_VIDEO SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO 系統將自動從現有委刊項指定目標中移除停用指定目標選項。 為避免服務中斷，請從任何現有的 YouTube 移除這個指定目標，並服務終止日期前的夥伴委刊項。
Oracle 第一方和第三方目標對象	2024 年 9 月 30 日	自 2024 年 9 月 30 日起，Oracle 的 FirstAndThirdPartyAudience 資源來源將停用。停用後，這些目標對象將從任何現有的資源指定目標和合併目標對像中移除。如果委刊項只指定停用的目標對象，或排除指定任何即將停用的目標對象，這項更新就會自動暫停該委刊項。 為避免服務中斷，請在停用日期前，從現有的委刊項指定目標對象和合併目標對像中找出並移除所有 Oracle 目標對象。
為部分出價策略設定最佳化指定目標對像功能的委刊項	2024 年 9 月 30 日	自 2024 年 9 月 30 日起，使用部分出價策略的 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 的 LineItem 資源，將 targetingExpansion.enableOptimizedTargeting 設為 False。BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM 為避免服務中斷，請更新並確定使用這些出價策略的委刊項並未開啟最佳化指定目標對像功能。
廣告訂單的「盡快」檔期 Pacing	2024 年 11 月 5 日	自 2024 年 11 月 5 日起，在設定廣告訂單 pacing 欄位時，PACING_TYPE_ASAP 將不再與 PACING_PERIOD_FLIGHT 相容。系統會將採用這項設定的所有現有廣告訂單的pacingType更新為 PACING_TYPE_AHEAD。 為避免服務中斷，請使用 PACING_TYPE_ASAP 和 PACING_PERIOD_FLIGHT 更新任何現有廣告訂單的 pacing。