已宣布的弃用

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

我们还会在 Google Ads 开发者博客上公布 API 的弃用和终止日期。

版本弃用

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

  • 发布:版本退出任何 Alpha 版或 Beta 版状态,并被视为稳定版。仍可能会为该版本发布新增功能。
  • 弃用:相应版本即将停用,并已宣布支持结束(停用)日期。用户必须在停用日期之前迁移到较新版本。我们将不再为该版本发布新增功能。
  • 已停用:相应版本已不再受支持。向该版本发出的请求会返回错误。

下表列出了所有现有的核心 Display & Video 360 API 版本、发布日期以及(如果已公布)弃用和终止日期。

API 版本 发行日期 下架日期 停用日期 迁移指南
v4 2025 年 3 月 27 日
v3 2023 年 10 月 31 日 2025 年 4 月 2 日 2025 年 10 月 7 日 从 v3 迁移到 v4
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 日:您将无法再将 GoogleAudienceTypeGOOGLE_AUDIENCE_TYPE_INSTALLED_APPSGOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICESGoogleAudience 资源分配给订单项或广告订单受众群体定位。如果请求将这些受众群体分配给订单项的受众群体定位,则会返回错误。如果所创建的订单项会在受众群体定位中包含已弃用的受众群体,则会包括 advertisers.lineItems.duplicateadvertisers.lineItems.generateDefault 请求。
  • 2023 年 6 月 8 日:受影响的受众群体将从所有订单项和插播订单定位以及所有组合受众群体中移除。如果移除了这些受众群体后,订单项无法投放广告,则系统会暂停该订单项。自该日期起,您也将无法再使用 googleAudiences 服务检索这些受众群体。

推荐的任务:

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

时间安排:

  • 2023 年 5 月 20 日:您将无法再将 AudienceTypeACTIVITY_BASEDFREQUENCY_CAPFirstAndThirdPartyAudience 资源分配给订单项或广告订单受众群体定位。如果请求将这些受众群体分配给订单项的受众群体定位,则会返回错误。如果所创建的订单项会在受众群体定位中包含已弃用的受众群体,则会包括 advertisers.lineItems.duplicateadvertisers.lineItems.generateDefault 请求。
  • 2023 年 6 月 8 日:受影响的受众群体将从所有订单项和插播订单定位以及所有组合受众群体中移除。如果移除了这些受众群体后,订单项无法投放广告,则系统会暂停该订单项。自该日期起,您也将无法再使用 firstAndThirdPartyAudiences 服务检索这些受众群体。

推荐的任务:

  • 我们建议您在日后更新订单项定位条件时,立即停止使用受影响的受众群体。
  • 从现有订单项和广告订单定位中移除所有受影响的受众群体。如需了解如何更新受众群体定位,请参阅我们的目标受众群体指南
现有 API 配额限制 2023 年 5 月 30 日

自 2023 年 5 月 30 日起,现有使用限额将替换为混合配额结构,该结构具有以下特点:

  1. 取消了每个项目每天的请求数配额。
  2. 为符合条件的方法设置了每个广告客户每个项目每分钟的请求数配额。

这些新限制将提高 API 使用的灵活性,并允许广告客户并行处理请求。如需详细了解此变更,请参阅我们现有的配额限制文档

OR 运算符在 LIST 过滤条件中不同字段的限制之间的用法

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_dateflight.dateRange.endDate 字段过滤或排序列表请求

更新了初始生效日期

2023 年 6 月 21 日

自 2023 年 6 月 21 日起,budget.budget_segments.date_range.end_dateflight.dateRange.endDate 将不再是 advertisers.insertionOrders.listadvertisers.lineItems.list filterorderBy 查询参数中接受的字段。在此日期之后,如果请求在 filterorderBy 查询参数中使用这些字段,系统将返回错误。

请在 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_CLICKBILLABLE_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_CIVABIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TENBIDDING_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_ASAPPACING_PERIOD_FLIGHT 更新所有现有插单的 pacing

频次上限周期超过 30 天 2025 年 2 月 28 日

2025 年 2 月 28 日:

  • 如果请求创建或更新 LineItemInsertionOrderCampaign 资源以使用 FrequencyCap 对象,且该对象具有设置为 TIME_UNIT_LIFETIMEtimeUnit 字段或设置为 TIME_UNIT_MONTHtimeUnit 字段以及设置为 2 的 timeUnitCount 字段,则会返回 400 错误。
  • 如果订单项广告订单广告系列结构化数据文件中的条目具有以下特征,则在上传文件时将无法创建或更新:要么“频次周期”列的值为“整个生命周期”,要么“频次周期”列的值为“月”且“频次金额”列的值为“2”。
  • 现有广告系列、广告订单和订单项将更新为使用不超过 30 天的频次上限周期。

为避免服务中断,请执行以下操作:

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

2025 年 3 月 6 日:

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

为避免服务中断,请执行以下操作:

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

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

为避免服务中断,请更新您的集成,将 firstAndThirdPartyAudiences.list 请求的 pageSize 查询参数设置为您所需的页面大小。

新的 sdfdownloadtasks.create 合作伙伴/广告客户不匹配错误 2025 年 3 月 6 日

自 2025 年 3 月 6 日起,使用父实体过滤器按不是 partnerId 集中广告客户的子级的广告客户进行过滤的 sdfdownloadtasks.create 请求将开始返回 400 错误。

SDF 中的 YouTube 覆盖面订单项限制 2025 年 3 月 24 日

自 2025 年 3 月 24 日起,在创建或更新订单项时,结构化数据文件将要求使用更广泛的广告格式。这有以下含义:

  • SDF v6v7 不再支持创建具有 Subtype 值“覆盖面”的新订单项文件条目。
  • SDF 订单项文件中具有 Subtype 值“覆盖面”的新条目必须在 TrueView Video Ad Formats 列中使用“自适应”值。值为 Subtype“覆盖面”的现有条目无法更新其 TrueView Video Ad Formats 列值。
  • 如果结构化数据文件 (SDF) 订单项文件中的新条目的 Subtype 值为“覆盖面”,则需要填充 TrueView Video Ad Inventory Control 列。
自定义出价算法与 Floodlight 活动不匹配 2025 年 4 月 1 日

2025 年 4 月 1 日:

为避免服务中断,请将您的集成更新为:

  • 在分配自定义出价算法之前或同时,验证相关 Floodlight 活动是否已分配给订单项。
  • 在尝试更新之前,系统会先从所有订单项中取消分配现有的自定义出价算法。

第一方受众群体的会员有效期为无限期 2025 年 4 月 7 日

自 2025 年 4 月 7 日起,FirstAndThirdPartyAudience 资源将不再允许无限期受众群体成员资格。如果 firstAndThirdPartyAudiences.createfirstAndThirdPartyAudiences.patch 请求将 membershipDurationDays 字段值设置为 10,000,则会返回 400 错误。membershipDurationDays 字段值为 10,000 的现有受众群体将更新为 540,并且新的会员时长将追溯应用于现有会员。此操作会使所有有效期超过 540 天的会员资格失效。

为避免服务中断,请执行以下操作:

在 v4 中,此更改反映在 FirstPartyAndPartnerAudience 资源中。

结构化数据文件中的行动号召视频广告系列 2025 年 4 月 22 日

自 2025 年 4 月 22 日起,您将无法再使用结构化数据文件为行动号召视频广告系列制作订单项,因为这些广告系列将升级为需求开发广告系列。尝试上传的订单项条目如果Subtype列值为“Action”且Type列值为“TrueView”,则会失败。

为避免服务中断,请更新您的集成,以改用需求开发广告系列,而不是行动号召视频广告系列。

在结构化数据文件中,需求开发广告订单项需要视频合作伙伴广告资源来源 2025 年 4 月 22 日

自 2025 年 4 月 22 日起,对于 Type 列值为“需求开发广告系列”的订单项条目,您必须在 TrueView Inventory Source Targeting 列中添加值“视频合作伙伴”。开始强制执行此要求后,系统会为现有订单项回填相应值,并在下载新的结构化数据文件时包含该值。

为避免服务中断,请执行以下操作:

  • 更新您的集成,以在所有需求开发广告系列的订单项条目中包含“视频合作伙伴”值。
  • 更新集成,以使用 SDF v8.1 广告组Demand Gen Inventory Source StrategyDemand Gen Enabled Inventory Sources 在广告组级管理需求开发广告资源的来源。
订单项结构化数据文件中的“出价倍增系数”列 2025 年 5 月 1 日

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

YouTube 及合作伙伴订单项的内容类别设置 2025 年 6 月 12 日

自 2025 年 6 月 12 日起,我们将更新品牌适宜性体验,届时您将无法再在订单项级修改各个 YouTube 及合作伙伴订单项的内容分类配置。内容类别设置将仅在广告客户级进行控制。为适应此变化,Display & Video 360 API 和结构化数据文件将进行以下更改:

为避免服务中断,请执行以下操作:
通过广告订单优化功能更新订单项预算 2025 年 6 月 12 日

自 2025 年 6 月 12 日起,您将无法再更新父广告订单设置为使用自动出价策略进行优化的订单项目的预算设置。

为避免服务中断,请执行以下操作:
结构化数据文件的网站限制 2025 年 6 月 12 日

自 2025 年 6 月 12 日起,我们将移除针对 SDF 条目中定位的网址的现有限制,该限制之前会阻止纳入较新的网站。相反,SDF 将与 API 和界面行为保持一致,并允许定位网址,前提是这些网址的格式正确。

这与广告订单订单项文件中的 Site Targeting - IncludeSite Targeting - Exclude 列相关。
声明订单项是否投放欧盟政治广告 2025 年 9 月 8 日

自 2025 年 9 月 8 日起,在使用 Display & Video 360 API 或 SDF 创建新订单项时,您必须声明相应订单项是否会投放欧盟政治广告。您可以通过以下方式进行声明:

如果您的父广告客户不会包含任何投放欧盟政治广告的订单项,那么您可以使用 Display & Video 360 API Advertiser 资源中的 containsEuPoliticalAds 字段在广告客户一级进行声明。如果此字段设置为 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING,则广告客户下的所有新订单项都将分配相同的值(除非另有指定),并且广告客户下的所有现有订单项都将更新为使用相同的值(如果尚未设置值)。订单项的声明可以在创建后的任何时间使用界面、API 或 SDF 进行更新。

如果您无法在广告客户一级进行声明,或者已声明您的广告客户可能会投放欧盟政治广告,请在 2025 年 9 月 8 日之前更新您的 Display & Video 360 API 和 SDF 集成,以免服务中断: