已宣布的弃用

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

下表列出了所有已宣布的影响实时版本的功能弃用，并提供了初始生效日期、弃用说明、推荐措施以及相关文档的链接：

功能	初始生效日期	说明
YouTube 自适应广告必须提供商家名称和徽标值 初始生效日期已更新	2027 年 1 月	自 2027 年 1 月起，如果广告客户未设置默认值，则 YouTube 自适应广告必须提供商家名称和徽标素材资源。 因此，如果未向父级广告客户分配默认值，则必须为“自适应”类型的广告设置广告 SDF 中的 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 订单项 SDF 中的 Brand Safety Sensitivity Setting 列将不再允许使用“使用自定义”选项。 订单项结构化数据文件中的 Brand Safety Custom Settings 列将不再受支持，下载时将填充空值。
弃用数字内容标签排除功能	2026 年 10 月 1 日	自 2026 年 10 月 1 日起，您将无法再使用定位功能排除特定数字内容标签。为适应这一变化，我们将对 Display & Video 360 API 和结构化数据文件进行以下更改： 在分配 TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION 类型的定位条件时，以下 ContentRatingTier 枚举值将被弃用，并且 DigitalContentLabelAssignedTargetingOptionDetails 对象的 excludedContentRatingTier 字段将不再接受这些值： 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 Line Item（订单项）SDF 中的 Digital Content Labels - Exclude 列仅允许分配选项“?”，否则该列必须为空。尝试分配任何其他值都会导致上传时出错。
Nielsen 作为第三方供应商衡量品牌提升效果	2026 年 7 月 13 日	自 2026 年 7 月 13 日起，Nielsen 将不再能被指定为衡量品牌提升效果的第三方供应商。为适应这一变化，我们将对 Display & Video 360 API 和结构化数据文件进行以下更改： ThirdPartyMeasurementConfigs 对象字段 brandLiftVendorConfigs.vendor 下的 LineItem 资源将不再接受 ThirdPartyVendor 枚举值 THIRD_PARTY_VENDOR_NIELSEN。 订单项 SDF 中的 TrueView Third-Party Brand Lift Vendor 列将不再允许使用“Nielsen”选项。 我们将移除 Nielsen 作为品牌提升效果供应商的现有用途。 为避免服务中断，请从集成中移除将 Nielsen 指定为品牌提升效果供应商的所有分配。
默认商家名称和徽标继承	2026 年 7 月 13 日	自 2026 年 7 月 13 日起，YouTube 自适应广告将开始支持商家名称和徽标素材资源，并且所有未设置商家名称和徽标素材资源的需求开发广告和 YouTube 自适应广告都将沿用在广告客户级设置的所有默认值。与此同时，此项变更将导致 Display & Video 360 API 和结构化数据文件的行为发生以下变化： 如果为父级广告客户分配了默认值，则 ad_details 需求开发 AdGroupAd 资源中的 businessName、logo 和 logoImages 字段将不再是必填字段。如果未提供，广告将沿用广告客户级默认设置。 对于以下任一类型的广告，都可以在广告 SDF 中设置 Business Name 和 Logo Asset IDs 列：“自适应”“需求开发产品”“需求开发视频”“需求开发图片”和“需求开发轮播”。如果未针对相关广告条目设置这些列，并且已为父级广告客户分配默认值，则广告在保存后将沿用广告客户级默认值。 如果需求开发广告的父级广告客户已分配默认值，则广告 SDF 中的 Business Name 和 Logo Asset IDs 列不再是必填项。 如果在广告客户级设置了默认值，则该广告客户名下的所有广告都将具有指定的商家名称和徽标值。如果您不想为 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 如果广告订单 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 字段将不再更新。该功能将在日后完全移除。 订单项 SDF 中的 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 预算字段。 在 SDF 中：检查该订单项的父级广告订单的 SDF 条目是否将其 Insertion Order Optimization 列设置为 TRUE。如果是，请勿尝试更新订单项 SDF 条目的 Budget Type 或 Budget Amount 列。
结构化数据文件的网站限制	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 列中添加“视频合作伙伴”值。此项强制执行生效后，系统会为现有订单项回填该值，并在下载新的结构化数据文件时包含该值。 为避免服务中断，请执行以下操作： 请更新您的集成，在所有需求开发订单项条目中添加“视频合作伙伴”值。 更新您的集成，以便使用 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 请求尝试设置 ConversionCountingConfig 对象的 floodlightActivityConfigs 字段以及 MaximizeSpendBidStrategy 或 PerformanceGoalBidStrategy 对象的 customBiddingAlgorithmId 字段，但这些对象未使用匹配的 Floodlight 活动，则会返回 400 错误。 如果 MaximizeSpendBidStrategy 或 PerformanceGoalBidStrategy 对象的 customBiddingAlgorithmId 字段已设置，则尝试更新 ConversionCountingConfig 对象的 floodlightActivityConfigs 字段的 advertisers.lineItems.patch 请求将返回 400 错误。 如果订单项结构化数据文件中的条目在设置了“算法 ID”列的情况下尝试更新“转化 Floodlight 活动 ID”列，则在上传文件时将无法更新。 customBiddingAlgorithms.patch、customBiddingAlgorithms.rules.create、customBiddingAlgorithms.scripts.create 针对已分配给订单项的 CustomBiddingAlgorithm 资源的请求将返回错误。 为避免服务中断，请将集成更新为： 在分配自定义出价算法之前或同时，验证相关 Floodlight 活动是否已分配给订单项。 在尝试更新之前，现有自定义出价算法会从所有订单项中取消分配。

之前的功能弃用

如需了解影响已弃用 Display & Video 360 API 版本的已宣布弃用功能，请参阅已归档的弃用功能。