已宣布的弃用

本页面列出了 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 日：使用手动触发器的订单项将在展示广告网络和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 字段将停用。在此日期之后，如果向这些服务或这些字段发出请求，将返回错误。

建议采取的措施：
已安装的应用和新移动设备 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 日起，现有的用量限额将被采用混合配额结构所取代，混合配额结构如下：

  1. 消除每个项目每天的请求数配额。
  2. 针对符合条件的方法，将每个广告客户每个项目每分钟的请求配额编制成相应配额。

这些新的限额将让您更灵活地使用 API，并支持跨广告客户并行发出请求。有关此项变更的详细信息，请参阅我们的现有配额限制文档。
LIST 过滤条件中不同字段的限制之间使用了 OR 运算符

June 21, 2023

自 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 字段对列表请求进行过滤或排序

初始生效日期已更新

 June 21, 2023

自 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 请求 June 21, 2023

自 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 定义）及其子订单项将被归档。

这项变更会影响以下请求：
广告素材资源中的publisherReviewStatuses字段 2024 年 6 月 26 日

自 2024 年 6 月 26 日起，publisherReviewStatuses 字段将被弃用，在检索 Creative 资源时将为空。
适用于 YouTube 和合作伙伴订单项 2024 年 9 月 30 日

自 2024 年 9 月 30 日起，已确定的 YouTube 和合作伙伴订单项：

系统会自动从现有订单项定位条件中移除弃用的定位选项。

为避免服务中断，请从现有的 YouTube 和合作伙伴订单项。
Oracle 第一方受众群体和第三方受众群体 2024 年 9 月 30 日

Oracle 中的 FirstAndThirdPartyAudience 资源来源将于 2024 年 9 月 30 日停用。弃用后，这些受众群体将从所有现有的资源定位条件和组合受众群体中移除。如果某个订单项仅定位到已弃用的受众群体或排除任何已弃用的受众群体，则此项更新将自动暂停该订单项。

为避免服务中断，请在弃用日期之前从现有订单项受众群体定位和组合受众群体中找出并移除所有 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 设为 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM 的 LineItem 资源会更新，设为 targetingExpansion.enableOptimizedTargeting 设为 False。

为避免服务中断，请更新并确保使用这些出价策略的订单项未启用优化型定位。
广告订单的“尽快”排期 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。