已宣布的弃用

本页面列出了 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 日：您将无法再将 GoogleAudience 资源（GoogleAudienceType 为 GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS 或 GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES）分配给订单项或广告订单受众群体定位。将这些受众群体分配给订单项的受众群体定位的请求将返回错误。如果所创建的订单项在受众群体定位中包含已废弃的受众群体，则包括 advertisers.lineItems.duplicate 和 advertisers.lineItems.generateDefault 请求。
  • 2023 年 6 月 8 日：受影响的受众群体将从所有订单项和广告订单定位条件以及所有组合受众群体中移除。如果在移除这些受众群体后订单项无法投放广告，系统会将其暂停。届时，您将无法再使用 googleAudiences 服务检索这些受众群体。

推荐的任务：

  • 我们建议您日后更新订单项定位条件时，立即停止使用受影响的受众群体。
  • 从现有订单项和广告订单定位条件中移除所有受影响的受众群体。如需了解如何更新受众群体定位，请参阅我们的“目标对象群组”指南。
基于活动的受众群体和频次上限受众群体类型 FirstAndThirdPartyAudience 2023 年 5 月 20 日

时间线：

  • 2023 年 5 月 20 日：您将无法再将 FirstAndThirdPartyAudience 资源（AudienceType 为 ACTIVITY_BASED 或 FREQUENCY_CAP）分配给订单项或广告订单受众群体定位。将这些受众群体分配给订单项的受众群体定位的请求将返回错误。如果所创建的订单项在受众群体定位中包含已废弃的受众群体，则包括 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 日

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

为避免服务中断，请在弃用日期之前从现有订单项受众群体定位条件和组合受众群体中找出并移除所有 Oracle 受众群体。
针对部分出价策略的订单项优化型定位 2024 年 9 月 30 日

自 2024 年 9 月 30 日起，使用部分出价策略的LineItem资源将不再支持优化型定位。此次变更生效后，如果 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，则系统会更新 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。
频次上限期限超过 30 天 2025 年 2 月 28 日

2025 年 2 月 28 日：

  • 创建或更新 LineItem、InsertionOrder 和 Campaign 资源的请求若要使用 FrequencyCap 对象，且 timeUnit 字段设置为 TIME_UNIT_LIFETIME 或 timeUnit 字段设置为 TIME_UNIT_MONTH 且 timeUnitCount 字段设置为 2，则会返回 400 错误。
  • 如果订单项、广告订单和广告系列结构化数据文件中的条目“频次周期”列值为“生命周期”，或者“频次周期”列值为“月”，且“频次数额”列值为“2”，则在文件上传时将无法创建或更新。
  • 现有广告系列、广告订单和订单项将更新为使用不超过 30 天的频次上限周期。

为避免服务中断，请执行以下操作：

  • 将使用超过 30 天的频次上限期的现有广告系列、广告订单和订单项资源更新为不超过 30 天。
  • 使用 Display & Video 360 API 或结构化数据文件创建或更新广告系列、广告订单或订单项资源时，请验证您的集成是否未设置超过 30 天的频次上限期限。
针对使用固定出价的订单项的优化型定位 2025 年 3 月 6 日

2025 年 3 月 6 日：

  • 创建或更新 LineItem 资源的请求若将 BiddingStrategy 字段 fixedBid 和 TargetingExpansionConfig 字段 enableOptimizedTargeting 设置为 true，则会返回 400 错误。
  • 如果订单项结构化数据文件中的条目“出价策略类型”列值为“固定”，且“优化型定位”列值为“true”，则在文件上传时将无法创建或更新。
  • 系统将更新使用固定出价的现有订单项，以停用优化型定位。

为避免服务中断，请执行以下操作：

  • 更新同时使用固定出价和优化型定位的现有订单项资源。
  • 使用 Display & Video 360 API 或结构化数据文件创建或更新订单项资源时，请验证您的集成是否未设置固定出价策略和优化定位。
更新为 firstAndThirdPartyAudiences.list 默认页面大小 2025 年 3 月 6 日

2025 年 3 月 6 日，firstAndThirdPartyAudiences.list 请求的默认页面大小将从 100 更新为 5000。

为避免服务中断，请更新集成，将 firstAndThirdPartyAudiences.list 请求的 pageSize 查询参数设置为首选页面大小。
新增了 sdfdownloadtasks.create 合作伙伴/广告客户不匹配错误 2025 年 3 月 6 日

自 2025 年 3 月 6 日起，如果 sdfdownloadtasks.create 请求使用父级实体过滤器按广告客户过滤，且广告客户不是集合 partnerId 的子级，则将开始返回 400 错误。
自定义出价算法和 Floodlight 活动不匹配 2025 年 4 月 1 日

2025 年 4 月 1 日：

为避免服务中断，请将您的集成更新为：

  • 验证在分配自定义出价算法之前或同时，是否已将相关 Floodlight 活动分配给订单项。
  • 系统会先从所有订单项中取消分配现有自定义出价算法，然后再尝试进行更新。
第一方受众群体的成员资格有效期为无限 2025 年 4 月 7 日

自 2025 年 4 月 7 日起，FirstAndThirdPartyAudience 资源将不再允许受众群体成员资格有效期无限期延长。将 membershipDurationDays 字段值设置为 10,000 的 firstAndThirdPartyAudiences.create 和 firstAndThirdPartyAudiences.patch 请求将返回 400 错误。membershipDurationDays 字段值为 10,000 的现有受众群体将更新为 540，并且新的会员资格有效期将会向现有会员资格溯及应用。这将使所有超过 540 天的会员资格失效。

为避免服务中断，请执行以下操作：

在 v4 中，这项更改反映在 FirstPartyAndPartnerAudience 资源中。
订单项结构化数据文件中的“出价乘数”列 2025 年 5 月 1 日

自 2025 年 5 月 1 日起，如果订单项结构化数据文件中的条目尝试设置“出价乘数”列，则在文件上传时将无法创建或更新资源。