已宣布的弃用

本页列出了 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 开发者博客，了解 即将弃用的重要功能公告。

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

功能	初始生效日期	说明
YouTube 自适应广告必须提供商家名称和徽标值	2026 年 10 月 12 日	自 2026 年 10 月 12 日起，如果广告客户未设置默认值，则 YouTube 自适应广告必须提供商家名称和徽标素材资源。 因此，如果未为父级广告客户分配默认值，则必须为类型为“自适应”的广告设置广告结构化数据文件中的 Business Name 和 Logo Asset IDs 列。如果分配了默认值，但该列留空，则广告在保存时将沿用广告客户级默认值。
弃用敏感类别排除设置	2026 年 10 月 1 日	自 2026 年 10 月 1 日起，您在分配订单项定位条件时，将无法再排除大多数敏感类别。为适应此项变更，我们将对 Display &Video 360 API 和结构化数据文件进行以下更改： 在分配类型为 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION 的定位条件时，我们将弃用以下 SensitiveCategory 枚举值，并且不再接受这些值作为 SensitiveCategoryAssignedTargetingOptionDetails 对象的 excludedSensitiveCategory 字段的值： SENSITIVE_CATEGORY_ADULT SENSITIVE_CATEGORY_ALCOHOL SENSITIVE_CATEGORY_DEROGATORY SENSITIVE_CATEGORY_DOWNLOADS_SHARING SENSITIVE_CATEGORY_DRUGS SENSITIVE_CATEGORY_GAMBLING SENSITIVE_CATEGORY_POLITICS SENSITIVE_CATEGORY_PROFANITY SENSITIVE_CATEGORY_RELIGION SENSITIVE_CATEGORY_SENSITIVE_SOCIAL_ISSUES SENSITIVE_CATEGORY_SHOCKING SENSITIVE_CATEGORY_SUGGESTIVE SENSITIVE_CATEGORY_TOBACCO SENSITIVE_CATEGORY_TRAGEDY SENSITIVE_CATEGORY_TRANSPORTATION_ACCIDENTS SENSITIVE_CATEGORY_VIOLENCE SENSITIVE_CATEGORY_WEAPONS 订单项结构化数据文件中的 Brand Safety Sensitivity Setting 列将不再允许使用“Use custom”选项。 订单项结构化数据文件中的 Brand Safety Custom Settings 列将不再受支持，下载时会填充空值。
弃用数字内容标签排除设置	2026 年 10 月 1 日	自 2026 年 10 月 1 日起，您将无法再使用定位条件排除特定的数字内容标签。为适应此项变更，我们将对 Display &Video 360 API 和结构化数据文件进行以下更改： 我们将弃用以下 ContentRatingTier 枚举值，并且不再接受这些值作为 excludedContentRatingTier 对象的 DigitalContentLabelAssignedTargetingOptionDetails 字段的值： TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION: CONTENT_RATING_TIER_FAMILIES CONTENT_RATING_TIER_GENERAL CONTENT_RATING_TIER_MATURE CONTENT_RATING_TIER_PARENTAL_GUIDANCE CONTENT_RATING_TIER_TEENS CONTENT_RATING_TIER_UNSPECIFIED Digital Content Labels - Exclude 列在 订单项 结构化数据文件中将仅允许分配“?”选项，否则该列必须为空。尝试分配任何其他值都会导致上传时出错。
Nielsen 作为衡量品牌提升效果的第三方供应商	2026 年 7 月 13 日	自 2026 年 7 月 13 日起，您将无法再将 Nielsen 分配为衡量品牌提升效果的第三方供应商。为适应此项变更，我们将对 Display &Video 360 API 和结构化数据文件进行以下更改： 我们将不再接受 ThirdPartyVendor 枚举值 THIRD_PARTY_VENDOR_NIELSEN 作为 LineItem 资源中 ThirdPartyMeasurementConfigs 对象字段 brandLiftVendorConfigs.vendor 的值。 订单项结构化数据文件中的 TrueView Third-Party Brand Lift Vendor 列将不再允许使用“Nielsen”选项。 我们将移除 Nielsen 作为品牌提升效果衡量供应商的现有用法。 为避免服务中断，请从您的集成中移除 Nielsen 作为品牌提升效果衡量供应商的所有分配。
默认商家名称和徽标继承	2026 年 7 月 13 日	自 2026 年 7 月 13 日起，YouTube 自适应广告将开始支持商家名称和徽标素材资源，并且所有未设置商家名称和徽标素材资源的需求开发广告和 YouTube 自适应广告都将沿用在广告客户级设置的任何默认值。与此同时，此项变更将导致 Display &Video 360 API 和结构化数据文件的行为发生以下变化： 如果为父级广告客户分配了默认值，则需求开发广告系列 AdGroupAd 资源中的 ad_details 中的 businessName、logo 和 logoImages 字段将不再是必需字段。如果未提供，广告将沿用广告客户级默认值。 Business Name 和 Logo Asset IDs 列在 广告 结构化数据文件中将能够为具有以下任何类型的广告设置：“自适应”“需求开发产品”“需求开发视频”“需求开发图片”和“需求开发轮播”。如果未为相关广告条目设置这些列，并且为父级广告客户分配了默认值，则广告在保存时将沿用广告客户级默认值。 如果需求开发广告的父级广告客户已分配默认值，则 Business Name 和 Logo Asset IDs 列在 Ad 结构化数据文件中不再是必需字段。 如果在广告客户级设置了默认值，则该广告客户下的所有广告都将分配有商家名称和徽标值。如果您想为 YouTube 自适应广告保留未设置的商家名称和徽标素材资源值，请不要为广告客户设置默认值 。
在 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 广告系列结构化数据文件条目为以下列分配了值，则上传时会失败： 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 广告订单结构化数据文件条目为以下列分配了值，则上传时会失败： 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 或结构化数据文件创建新订单项时，必须声明订单项是否会投放欧盟政治广告。您可以通过以下方式进行声明： 使用 Display & Video 360 API LineItem 资源中的 containsEuPoliticalAds 字段。您还可以使用 advertisers.lineItems.duplicate 和 advertisers.lineItems.generateDefault 请求中的新字段进行此声明。 使用结构化数据文件 v9 订单项文件类型中的 Contains EU Political Ads 列。 如果您的父级广告客户不会包含任何投放欧盟政治广告的订单项，则您可以使用 Display & Video 360 API Advertiser 资源中的 containsEuPoliticalAds 字段在广告客户级进行声明。如果此字段设置为 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING，则广告客户下的所有新订单项都将分配有相同的值（除非另有规定），并且广告客户下的所有现有订单项都将更新为使用相同的值（如果尚未设置值）。您可以在创建订单项后的任何时间使用界面、API 或结构化数据文件更新订单项的声明。 如果您无法在广告客户级进行声明，或者已声明您的广告客户可能会投放欧盟政治广告，请在 2025 年 9 月 8 日 之前更新您的 Display & Video 360 API 和结构化数据文件集成，以避免服务中断： 在发出 advertisers.lineItems.create 请求时，在新 LineItem 资源中设置 containsEuPoliticalAds 字段。 在任何 advertisers.lineItems.duplicate 和 advertisers.lineItems.generateDefault 请求的请求正文中设置 containsEuPoliticalAds 字段。 迁移以使用结构化数据文件 v9，并在上传时为任何新订单项设置 Contains EU Political Ads 列，将其设置为 Yes 或 No。如需了解分步说明，请参阅我们的 v9 迁移指南。 在使用 Display &Video 360 API 或结构化数据文件更新现有订单项的地理位置定位条件之前，请先更新订单项以提供声明。
YouTube 及合作伙伴订单项的内容类别设置	2025 年 6 月 12 日	2025 年 6 月 12 日，我们将更新 品牌适宜性体验，届时您将无法再在订单项级修改各个 YouTube 及合作伙伴订单项的内容分类配置。内容分类设置将改为仅在广告客户级进行控制。为适应此项变更，我们将对 Display &Video 360 API 和结构化数据文件进行以下更改： 我们将不再更新 YouTube 及合作伙伴 LineItem 资源的 YoutubeAndPartnersSettings 对象中的 contentCategory 字段。我们将在稍后彻底移除该字段。 订单项结构化数据文件中的 TrueView Content Filter 列将不再可写。 为避免服务中断，请执行以下操作： 在 API 中查看 YouTube 及合作伙伴订单项时，检索 effectiveContentCategory 字段，而不是 contentCategory 字段。 更新 结构化数据文件订单项 条目时，请停止修改 TrueView Content Filter 列。创建新订单项时，请将该列留空。
使用广告订单优化功能更新订单项预算	2025 年 6 月 12 日	自 2025 年 6 月 12 日起，您将无法再更新父级广告订单设置为使用自动出价策略进行优化的订单项的预算设置。 为避免服务中断，请执行以下操作： 在 API 中：检查订单项的父级 InsertionOrder 是否设置了 bidStrategy.maximizeSpendAutoBid 或 bidStrategy.performanceGoalAutoBid。如果是，请勿尝试使用 advertisers.lineItems.patch 更新 LineItem 预算字段。 在结构化数据文件中：检查订单项的父级 广告订单 的结构化数据文件条目的 Insertion Order Optimization 列是否设置为 TRUE。如果是，请勿尝试更新 Budget Type 或 Budget Amount 列，以用于 订单项 结构化数据文件条目。
结构化数据文件的网站限制	2025 年 6 月 12 日	自 2025 年 6 月 12 日起，我们将移除针对结构化数据文件条目中定位的网址的现有限制，该限制会阻止纳入较新的网站。相反，结构化数据文件将与 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”值。此项强制措施开始实施后，系统将为现有订单项回填该值，并在下载新的结构化数据文件时添加该值。 为避免服务中断，请执行以下操作： 更新您的集成，以便在所有需求开发订单项条目中添加“Video Partners”值。 更新您的集成，以便使用 结构化数据文件 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 请求尝试更新 ConversionCountingConfig 对象的 floodlightActivityConfigs 字段，同时设置了 MaximizeSpendBidStrategy 或 PerformanceGoalBidStrategy 对象的 customBiddingAlgorithmId 字段，则系统将返回 400 错误。 如果 订单项结构化数据文件中的条目尝试在设置了“Algorithm Id”列的情况下更新“Conversion Floodlight Activity Ids”列，则在上传文件时将无法更新。 customBiddingAlgorithms.patch、customBiddingAlgorithms.rules.create、customBiddingAlgorithms.scripts.create 请求针对分配给订单项的 CustomBiddingAlgorithm 资源，则系统将返回错误。 为避免服务中断，请更新您的集成，以便： 在分配自定义出价算法之前或同时，验证是否已为订单项分配了相关的 Floodlight 活动。 在尝试更新之前，从所有订单项中取消分配现有自定义出价算法。

之前弃用的功能

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