已宣布的弃用

本页列出了 Display & Video 360 API 中 API 版本和各个功能的弃用和停用日期。

我们将在 Google Ads 开发者博客上公布该 API 的弃用和停用日期。

版本弃用

Display & Video 360 API 版本会定期发布、弃用和弃用。这些步骤的定义如下：

  • 发布：该版本会退出任何 Alpha 版或 Beta 版状态，并被视为稳定版。我们可能仍会针对该版本发布新增功能。
  • 弃用：该版本将停用，并宣布停止支持（停止提供）日期。用户必须在弃用日期之前迁移到较新版本。我们将不再针对该版本发布增加的功能。
  • 停用：该版本不再受支持。向该版本发出的请求会返回错误。

下表列出了所有现有核心 Display & 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 月初逐步推出。我们在这篇博文中宣布了对 Display & Video 360 API 和结构化数据文件行为的相关变更以及建议采取的措施。
手动触发器 2023 年 5 月 17 日

时间轴：

  • 2023 年 5 月 17 日：使用手动触发器的订单项将在 Display & 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 日之前移除使用这 4 个字段的所有过滤逻辑，以免服务中断。
按结果付费 2023 年 8 月 1 日

2023 年 8 月 1 日，使用按结果付费（由 billableOutcome 字段值 BILLABLE_OUTCOME_PAY_PER_CLICK 或 BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION 所定义）的广告订单及其子订单项将会归档。

这项变更将影响以下请求：