已归档的功能弃用

下表列出了已公布的会影响已停用的 Display & Video 360 API 或结构化数据文件版本的弃用功能。其中包含初始生效日期、弃用说明、建议的操作以及相关文档的链接：

功能 初始生效日期 说明
SDF 中的 YouTube 覆盖面订单项限制 2025 年 3 月 24 日

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

  • SDF v6 和 v7 不再支持创建具有 Subtype 值“覆盖面”的新订单项文件条目。
  • SDF 订单项文件中具有 Subtype 值“覆盖面”的新条目必须在 TrueView Video Ad Formats 列中使用“自适应”值。Subtype 值为“覆盖面”的现有条目无法更新其 TrueView Video Ad Formats 列值。
  • 如果结构化数据文件 (SDF) 订单项文件中的新条目的 Subtype 值为“覆盖面”，则需要填充 TrueView Video Ad Inventory Control 列。
新的sdfdownloadtasks.create合作伙伴/广告客户不匹配错误 2025 年 3 月 6 日

自 2025 年 3 月 6 日起，使用父实体过滤器按不是 partnerId 的子级的广告客户进行过滤的 sdfdownloadtasks.create 请求将开始返回 400 错误。
更新为 firstAndThirdPartyAudiences.list 默认页面大小 2025 年 3 月 6 日

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

为避免服务中断，请更新您的集成，将 firstAndThirdPartyAudiences.list 请求的 pageSize 查询参数设置为您所需的页面大小。
使用固定出价的订单项的优化型定位 2025 年 3 月 6 日

2025 年 3 月 6 日：

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

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

  • 更新同时使用固定出价和优化型定位的现有订单项资源。
  • 验证您的集成在通过 Display & Video 360 API 或结构化数据文件创建或更新订单项资源时，是否未设置固定的出价策略和优化型定位。
频次上限周期超过 30 天 2025 年 2 月 28 日

2025 年 2 月 28 日：

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

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

  • 将使用超过 30 天的频次上限周期的现有广告系列、广告订单和订单项资源更新为 30 天或更短。
  • 验证您的集成在通过 Display & Video 360 API 或结构化数据文件创建或更新广告系列、广告订单或订单项资源时，是否未设置超过 30 天的频次上限周期。
广告订单的“排期 - 尽快”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。
针对部分出价策略的订单项优化型定位 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。

为避免服务中断，请更新并验证使用这些出价策略的订单项是否未启用优化型定位。
Oracle 第一方和第三方受众群体 2024 年 9 月 30 日

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

为避免服务中断，请在停用日期之前，从现有订单项受众群体定位和组合受众群体中识别并移除所有 Oracle 受众群体。
YouTube 及合作伙伴订单项的内容定位 2024 年 9 月 30 日

自 2024 年 9 月 30 日起，YouTube 及合作伙伴订单项将不再支持以下已确定的定位类型值：

系统会自动从现有订单项定位中移除已停用的定位选项。这些值仍可用于广告客户级定位。

为避免服务中断，请在停用日期之前从所有现有的 YouTube 及合作伙伴订单项中移除此定位条件。
广告素材资源中的 publisherReviewStatuses 字段 2024 年 6 月 26 日

自 2024 年 6 月 26 日起，publisherReviewStatuses 字段将被弃用，并且在检索 Creative 资源时为空。
按结果付费购买 2023 年 8 月 1 日

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

此项变更会影响以下请求：
能够按另外四个字段过滤 advertisers.lineItems.list 请求 2023 年 6 月 21 日

自 2023 年 6 月 21 日起，advertisers.lineItems.list 将不再支持按以下字段进行过滤：

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

请在 2023 年 6 月 21 日之前移除使用这四个字段的所有过滤条件逻辑，以免服务中断。
能够按 budget.budget_segments.date_range.end_date 和 flight.dateRange.endDate 字段过滤或排序列表请求

更新了初始生效日期

 2023 年 6 月 21 日

自 2023 年 6 月 21 日起，budget.budget_segments.date_range.end_date 和 flight.dateRange.endDate 将不再是 advertisers.insertionOrders.list 和 advertisers.lineItems.list filter 和 orderBy 查询参数中接受的字段。在此日期之后，如果请求在 filter 和 orderBy 查询参数中使用这些字段，则会返回错误。

请在 2023 年 6 月 21 日之前移除使用这两个字段的所有过滤和排序逻辑，以免服务中断。
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 逻辑运算符，以免服务中断。
现有 API 配额限制 2023 年 5 月 30 日

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

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

这些新限制将提高 API 使用的灵活性，并允许跨广告客户同时载入请求。如需详细了解此变更，请参阅我们现有的配额限制文档。
基于活动和频次上限的FirstAndThirdPartyAudience类型 2023 年 5 月 20 日

时间安排：

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

建议执行的任务：

  • 我们建议您在日后更新订单项定位条件时，立即停止使用受影响的受众群体。
  • 从现有订单项和广告订单定位中移除所有受影响的受众群体。如需了解如何更新受众群体定位，请参阅我们的目标受众群体指南。
已安装的应用和新移动设备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 服务检索这些受众群体。

建议执行的任务：

  • 我们建议您在日后更新订单项定位条件时，立即停止使用受影响的受众群体。
  • 从现有订单项和广告订单定位中移除所有受影响的受众群体。如需了解如何更新受众群体定位，请参阅我们的目标受众群体指南。
手动触发器 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 字段将停用。在此日期之后，如果向这些服务或这些字段发出请求，则将返回错误。

建议采取的措施：
定位范围扩展 2023 年 3 月 25 日 优化型定位功能取代定位范围扩展功能，从 2023 年 3 月 25 日到 2023 年 5 月初逐步推出。我们已在博文中公布了 Display & Video 360 API 和结构化数据文件行为的相关变更以及建议采取的行动。