已宣布的弃用

时间安排：

• 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 字段将停用。在此日期之后，向这些服务或这些字段发出的请求将返回错误。

建议采取的措施：

• 立即停止使用手动触发器来开始和停止订单项投放。
• 停止向 advertisers.manualTriggers 服务发出请求。
• 使用手动触发器更新所有订单项的 flight.flightDateType 和 flight.triggerId 字段。

时间安排：

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

推荐的任务：

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

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

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

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

自 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 逻辑运算符，以免服务中断。

更新了初始生效日期

自 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 日之前移除使用这两个字段的所有过滤和排序逻辑，以免服务中断。

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

• flight.triggerId
• targetedChannelId
• targetedNegativeKeywordListId
• warningMessages

请在 2023 年 6 月 21 日之前移除使用这四个字段的所有过滤条件逻辑，以免服务中断。

自 2023 年 8 月 1 日起，采用基于效果的购买方式（由 billableOutcome 字段值 BILLABLE_OUTCOME_PAY_PER_CLICK 或 BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION 定义）的植入订单及其子订单项将被归档。

此项变更会影响以下请求：

• 尝试使用 advertisers.insertionOrders.create 创建采用按结果付费的广告订单时，系统会返回 400 错误
• 尝试使用 advertisers.lineItems.create、advertisers.lineItems.duplicate 或 advertisers.lineItems.generateDefault 在使用基于效果的购买方式的广告订单下创建订单项时，系统会返回 400 错误
• 鉴于默认情况下，归档的资源不会包含在 LIST 请求中，受影响的资源将不再默认由 advertisers.insertionOrders.list 和 advertisers.lineItems.list 方法返回。

自 2024 年 6 月 26 日起，publisherReviewStatuses 字段将被弃用，并且在检索 Creative 资源时为空。

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

• TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION：
• CONTENT_RATING_TIER_UNRATED
• CONTENT_RATING_TIER_GENERAL
• CONTENT_RATING_TIER_PARENTAL_GUIDANCE
• CONTENT_RATING_TIER_TEENS
• CONTENT_RATING_TIER_MATURE
• CONTENT_RATING_TIER_FAMILIES
• TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION：
• SENSITIVE_CATEGORY_EMBEDDED_VIDEO
• SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

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

为避免服务出现任何中断，请在停用日期之前从所有现有的 YouTube 及合作伙伴订单项中移除此定位条件。

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

为避免服务中断，请在停用日期之前，从现有订单项受众群体定位条件和组合受众群体中找出并移除所有 Oracle 受众群体。

自 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。

为避免服务中断，请更新并验证使用这些出价策略的订单项是否未启用优化型定位。

自 2024 年 11 月 5 日起，在设置广告订单的 pacing 字段时，PACING_TYPE_ASAP 将不再与 PACING_PERIOD_FLIGHT 兼容。所有采用此配置的现有广告订单的 pacingType 将更新为 PACING_TYPE_AHEAD。

为避免服务中断，请使用 PACING_TYPE_ASAP 和 PACING_PERIOD_FLIGHT 更新所有现有插单的 pacing。

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 天的频次上限周期。

2025 年 3 月 6 日：

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

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

• 更新同时使用固定出价和优化型定位的现有订单项资源。
• 验证您的集成在通过 Display & Video 360 API 或结构化数据文件创建或更新订单项资源时，是否未设置固定的出价策略和优化后的定位条件。

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

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

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

自 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 列。

2025 年 4 月 1 日：

• 尝试设置 ConversionCountingConfig 对象的 floodlightActivityConfigs 字段以及未使用匹配的 Floodlight 活动的 MaximizeSpendBidStrategy 或 PerformanceGoalBidStrategy 对象的 customBiddingAlgorithmId 字段的 advertisers.lineItems.create 请求将返回 400 错误。
• 如果尝试更新 ConversionCountingConfig 对象的 floodlightActivityConfigs 字段，同时设置了 MaximizeSpendBidStrategy 或 PerformanceGoalBidStrategy 对象的 customBiddingAlgorithmId 字段，则 advertisers.lineItems.patch 请求将返回 400 错误。
• 如果 Line Item 结构化数据文件中尝试更新“Conversion Floodlight Activity Ids”（转化 Floodlight 活动 ID）列的条目在上传文件时“Algorithm Id”（算法 ID）列已设置，则更新会失败。
• 针对分配给订单项的 CustomBiddingAlgorithm 资源的 customBiddingAlgorithms.patch、customBiddingAlgorithms.rules.create、customBiddingAlgorithms.scripts.create 请求将返回错误。

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

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

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

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

• 验证您的集成是否未将新受众群体或现有受众群体的 membershipDurationDays 字段值设置为 10,000。
• 使用 firstAndThirdPartyAudiences.editCustomerMatchMembers 刷新现有目标客户匹配受众群的成员资格。
• 定期刷新目标客户匹配受众群体的成员资格，确保受众群体的名单规模不会意外缩小。

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

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

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

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

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

• 更新您的集成，以在所有需求开发广告系列的订单项条目中包含“视频合作伙伴”值。
• 更新集成，以使用 SDF v8.1 广告组列 Demand Gen Inventory Source Strategy 和 Demand Gen Enabled Inventory Sources 在广告组级管理需求开发广告资源的来源。

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

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

• YouTube 及合作伙伴 LineItem 资源的 YoutubeAndPartnersSettings 对象的 contentCategory 字段将不再更新。我们将在日后完全移除该功能。
• 订单项 SDF 中的 TrueView Content Filter 列将不再可写入。

• 在 API 中查看 YouTube 及合作伙伴订单项时，检索 effectiveContentCategory 字段，而不是 contentCategory 字段。
• 更新 SDF 订单项条目时，停止修改 TrueView Content Filter 列。创建新订单项时，请将此列留空。

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

• 在 API 中：检查订单项的父级 InsertionOrder 是否已设置 bidStrategy.maximizeSpendAutoBid 或 bidStrategy.performanceGoalAutoBid。如果是，请勿尝试使用 advertisers.lineItems.patch 更新 LineItem 预算字段。
• 在 SDF 中：检查相应订单项的父级广告订单的 SDF 条目的 Insertion Order Optimization 列是否设置为 TRUE。如果是，请勿尝试更新 line item SDF 条目的 Budget Type 或 Budget Amount 列。

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

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

• 使用 Display & Video 360 API LineItem 资源中的 containsEuPoliticalAds 字段。您还可以使用 advertisers.lineItems.duplicate 和 advertisers.lineItems.generateDefault 请求中的新字段进行此声明。
• 在 SDF v9 订单项文件类型中使用 Contains EU Political Ads 列。

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

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

• 在发出 advertisers.lineItems.create 请求时，在新 LineItem 资源中设置 containsEuPoliticalAds 字段。
• 在任何 advertisers.lineItems.duplicate 和 advertisers.lineItems.generateDefault 请求的正文中设置 containsEuPoliticalAds 字段。
• 迁移为使用结构化数据文件 v9，并在上传时将所有新订单项的 Contains EU Political Ads 列设置为 Yes 或 No。如需查看分步说明，请参阅我们的 v9 迁移指南。
• 在使用 Display & Video 360 API 或 SDF 更新现有订单项的地理位置定位之前，请先更新该订单项以提供声明。