公告淘汰

本頁面列出 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`。