已宣布的弃用

本页列出了 API 版本和各项功能在 Display & Video 360 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 开发者博客。

下表列出了所有已公布的、会影响正式版的功能弃用，并提供了初始生效日期、弃用说明、建议的操作以及相关文档的链接：

功能	初始生效日期	说明
在 Display &Video 360 API 和结构化数据文件中管理广告订单和广告系列定位条件	2026 年 2 月 23 日	2026 年 2 月 23 日，Display &Video 360 将停用广告订单和广告系列定位条件。我们将对 Display &Video 360 API 和结构化数据文件 (SDF) 进行更改，以与此变更保持一致。在 Display &Video 360 API 中，部分方法将停用，如果调用这些方法，系统会返回错误。在 SDF 中，广告订单和广告系列文件中的定位条件列在下载时将不再填充，并且在上载时必须为空。建议用户在创建订单项时直接为订单项分配定位条件。 如果调用以下 Display &Video 360 API 方法，系统会返回 404 错误： advertisers.campaigns.listAssignedTargetingOptions advertisers.campaigns.targetingTypes.assignedTargetingOptions.get advertisers.campaigns.targetingTypes.assignedTargetingOptions.list advertisers.insertionOrders.listAssignedTargetingOptions advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.create advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.delete advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.get advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list advertisers.lineItems.generateDefault 广告系列 SDF 条目如果为以下列分配了值，则在上载时会失败： Demographic Targeting Gender Demographic Targeting Age Demographic Targeting Household Income Demographic Targeting Parental Status Geography Targeting - Include Geography Targeting - Exclude Language Targeting - Include Language Targeting - Exclude Digital Content Labels - Exclude Brand Safety Sensitivity Setting Brand Safety Custom Settings Third Party Verification Services Third Party Verification Labels Viewability Targeting Active View Position Targeting - Display On Screen Position Targeting - Video On Screen Position Targeting - Display Position In Content Position Targeting - Video Position In Content Inventory Source Targeting - Authorized Seller Options Inventory Source Targeting - Include Inventory Source Targeting - Exclude Inventory Source Targeting - Target New Exchanges Environment Targeting 广告订单 SDF 条目为以下列分配了值，则在上载时会失败： Geography Targeting - Include Geography Targeting - Exclude Proximity Targeting Proximity Location List Targeting Language Targeting - Include Language Targeting - Exclude Device Targeting - Include Device Targeting - Exclude Browser Targeting - Include Browser Targeting - Exclude Digital Content Labels - Exclude Brand Safety Sensitivity Setting Brand Safety Custom Settings Third Party Verification Services Third Party Verification Labels Channel Targeting - Include Channel Targeting - Exclude Site Targeting - Include Site Targeting - Exclude App Targeting - Include App Targeting - Exclude App Collection Targeting - Include App Collection Targeting - Exclude Category Targeting - Include Category Targeting - Exclude Content Genre Targeting - Include Content Genre Targeting - Exclude Keyword Targeting - Include Keyword Targeting - Exclude Keyword List Targeting - Exclude Audience Targeting - Include Audience Targeting - Exclude Affinity & In Market Targeting - Include Affinity & In Market Targeting - Exclude Custom List Targeting Inventory Source Targeting - Authorized Seller Options Inventory Source Targeting - Include Inventory Source Targeting - Exclude Inventory Source Targeting - Target New Exchanges Daypart Targeting Daypart Targeting Time Zone Environment Targeting Viewability Omid Targeting Enabled Viewability Targeting Active View Position Targeting - Display On Screen Position Targeting - Video On Screen Position Targeting - Display Position In Content Position Targeting - Video Position In Content Position Targeting - Audio Position In Content Video Player Size Targeting Content Duration Targeting Content Stream Type Targeting Audio Content Type Targeting Demographic Targeting Gender Demographic Targeting Age Demographic Targeting Household Income Demographic Targeting Parental Status Connection Speed Targeting Carrier Targeting - Include Carrier Targeting - Exclude
声明订单项是否投放欧盟政治广告	2025 年 9 月 8 日	自 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 更新现有订单项的地理位置定位条件之前，请先更新订单项以提供声明。
YouTube 及合作伙伴订单项的内容类别设置	2025 年 6 月 12 日	2025 年 6 月 12 日，我们将更新 品牌适宜性体验，届时您将无法再在订单项一级修改各个 YouTube 及合作伙伴订单项的内容分类配置。内容分类设置将改为仅在广告客户一级进行控制。为适应此变更，我们将对 Display &Video 360 API 和结构化数据文件进行以下更改： 我们将不再更新 YouTube 及合作伙伴 LineItem 资源的 YoutubeAndPartnersSettings 对象中的 contentCategory 字段。我们将在稍后完全移除该字段。 TrueView Content Filter 列在 订单项 SDF 中将不再可写。 为避免服务中断，请执行以下操作： 在 API 中查看 YouTube 及合作伙伴订单项时，检索 effectiveContentCategory 字段，而不是 contentCategory 字段。 更新 SDF 订单项条目时，停止修改 TrueView Content Filter 列。创建新订单项时，请将该列留空。
通过广告订单优化更新订单项预算	2025 年 6 月 12 日	自 2025 年 6 月 12 日起，您将无法再更新父级广告订单设置为使用自动出价策略进行优化的订单项的预算设置。 为避免服务中断，请执行以下操作： 在 API 中：检查订单项的父级 InsertionOrder 是否设置了 bidStrategy.maximizeSpendAutoBid 或 bidStrategy.performanceGoalAutoBid。如果是，请勿尝试使用 advertisers.lineItems.patch 更新 LineItem 预算字段。 在 SDF 中：检查订单项的父级 广告订单 的 SDF 条目的 Insertion Order Optimization 列是否设置为 TRUE。如果是，请勿尝试更新 Budget Type 或 Budget Amount 列，以用于 订单项 SDF 条目。
结构化数据文件的网站限制	2025 年 6 月 12 日	自 2025 年 6 月 12 日起，我们将移除针对 SDF 条目中定位的网址的现有限制，该限制会阻止纳入较新的网站。相反，SDF 将与 API 和界面行为保持一致，并允许定位网址，只要这些网址的格式正确即可。 这与广告订单和订单项文件中的 Site Targeting - Include 和 Site Targeting - Exclude 列相关。
订单项结构化数据文件中的“出价系数”列	2025 年 5 月 1 日	2025 年 5 月 1 日，如果 订单项结构化数据文件中的条目尝试设置“出价系数”列，则在上载文件时将无法创建或更新资源。
要求在结构化数据文件中为需求开发订单项提供视频合作伙伴广告资源来源	2025 年 4 月 22 日	自 2025 年 4 月 22 日起，如果 订单项条目的 Type 列值为“需求开发”，则必须在 TrueView Inventory Source Targeting 列中添加值“视频合作伙伴”。此项强制措施开始实施后，系统将为现有订单项回填该值，并在下载新的结构化数据文件时添加该值。 为避免服务中断，请执行以下操作： 更新您的集成，以便在所有需求开发订单项条目中添加“Video Partners”值。 更新您的集成，以便使用 SDF v8.1 广告组 列 Demand Gen Inventory Source Strategy 和 Demand Gen Enabled Inventory Sources 在广告组一级管理需求开发广告资源来源。
结构化数据文件中的行动号召视频广告系列	2025 年 4 月 22 日	2025 年 4 月 22 日，您将无法再使用结构化数据文件为行动号召视频广告系列创建订单项，因为这些广告系列将升级为需求开发广告系列。尝试上载的订单项条目如果 Subtype 列值为“Action”，且 Type 列值为“TrueView”，则会失败。 为避免服务中断，请更新您的集成，以便使用需求开发广告系列而不是行动号召视频广告系列。
第一方受众群体的成员资格有效期无限	2025 年 4 月 7 日	2025 年 4 月 7 日，FirstAndThirdPartyAudience 资源将不再允许无限的受众群体成员资格有效期。firstAndThirdPartyAudiences.create 和 firstAndThirdPartyAudiences.patch 请求将 membershipDurationDays 字段值设置为 10,000，则会返回 400 错误。如果现有受众群体的 membershipDurationDays 字段值为 10,000，则会更新为 540，并且新的成员资格有效期将追溯应用于现有成员资格。这将使所有有效期超过 540 天的成员资格过期。 为避免服务中断，请执行以下操作： 验证您的集成是否未将新受众群体或现有受众群体的 membershipDurationDays 字段值设置为 10,000。 使用 firstAndThirdPartyAudiences.editCustomerMatchMembers 刷新现有目标客户匹配受众群体的成员资格。 定期刷新目标客户匹配受众群体的成员资格，确保受众群体的名单大小不会意外缩小。 在 v4 中，此变更反映在 FirstPartyAndPartnerAudience 资源中。
自定义出价算法与 Floodlight 活动不匹配	2025 年 4 月 1 日	2025 年 4 月 1 日： advertisers.lineItems.create 请求尝试设置 floodlightActivityConfigs 对象的 ConversionCountingConfig 字段，以及不使用匹配的 Floodlight 活动的 MaximizeSpendBidStrategy 或 PerformanceGoalBidStrategy 对象的 customBiddingAlgorithmId 字段，则会返回 400 错误。 advertisers.lineItems.patch 请求尝试更新 floodlightActivityConfigs 字段的 ConversionCountingConfig 对象，同时设置了 customBiddingAlgorithmId 字段的 MaximizeSpendBidStrategy 或 PerformanceGoalBidStrategy 对象，则会返回 400 错误。 如果订单项结构化数据文件中的条目尝试在设置了“Algorithm Id”列的情况下更新“Conversion Floodlight Activity Ids”列，则在上载文件时将无法更新。 customBiddingAlgorithms.patch、customBiddingAlgorithms.rules.create、customBiddingAlgorithms.scripts.create 请求针对分配给订单项的 CustomBiddingAlgorithm 资源，则会返回错误。 为避免服务中断，请更新您的集成，以便： 在分配自定义出价算法之前或同时，验证相关 Floodlight 活动是否已分配给订单项。 在尝试更新之前，从所有订单项中取消分配现有自定义出价算法。

之前弃用的功能

如需了解已公布的、会影响已停用的 Display & Video 360 API 版本的弃用， 请参阅我们的 已归档弃用。