为支持欧盟政治广告法规而在 Display & Video 360 API 和结构化数据文件中进行的变更

2025 年 8 月 21 日，星期四

有何变化？

正如我们去年宣布的那样，Google 将在 2025 年 10 月新法规生效之前停止在欧盟 (EU) 境内投放政治广告。自 2025 年 9 月 8 日起，Display & Video 360 API 和结构化数据文件 (SDF) 将开始执行与此变更相关的违规处置。如果您使用上述任一产品来创建或管理订单项，则可能需要在 2025 年 9 月 8 日之前更新应用，以处理这些强制措施，从而避免服务中断。

背景

自 2025 年 9 月 8 日起，Display & Video 360 将要求针对欧盟政治广告自行做出声明。创建订单项时，您必须声明该订单项是否会投放欧盟政治广告。

您也可以为整个广告客户进行此声明。此声明将指明该广告客户名下的任何订单项是否会投放欧盟政治广告。在 9 月 8 日之后，您可以使用 Display & Video 360 API 在广告客户级别进行声明，也可以在 Display & Video 360 界面中的广告客户基本详情设置下进行声明。如果您声明您的广告客户不会投放欧盟政治广告，那么该广告客户名下的新订单项在未提供其他声明的情况下，将使用该声明，从而避免服务中断。

Display & Video 360 API 和结构化数据文件已新增支持，可用于声明订单项是否投放欧盟政治广告。自 2025 年 9 月 8 日起，Display & Video 360 界面也将推出类似的自行声明支持。

Display & Video 360 API

在 Display & Video 360 API 中，containsEuPoliticalAds 字段已添加到 v3 和 v4 中的以下 API 对象，以便在不同的资源级别显示自行声明：

• LineItem 对象，用于在订单项级获取和设置声明。
• Advertiser，用于在广告客户层级获取和设置声明。

下表显示了该字段可能的可设置值，其含义与所分配的资源相关。

值	含义
CONTAINS_EU_POLITICAL_ADVERTISING	该资源将用于投放欧盟政治广告。
DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING	该资源不会用于投放欧盟政治广告。

自 2025 年 9 月 8 日起，Display & Video 360 API 将开始要求为新的订单项资源设置 containsEuPoliticalAds 字段，或在更新现有订单项的地理位置定位时为现有订单项资源设置该字段。

我需要做什么？

对于所创建的每个新订单项，都需要使用 containsEuPoliticalAds 字段提供有效的声明。

使用 advertisers.patch 方法在 Advertiser 对象中设置 containsEuPoliticalAds 字段，或在 Display & Video 360 界面中的广告客户基本详情设置下设置声明（功能推出后）。如果您将父级广告主的 containsEuPoliticalAds 字段设置为 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING，则新订单项将使用该值（除非在创建时设置了其他值），并且系统会在一天内为现有订单项回填该字段。然后，您可以使用界面、API 或结构化数据文件更新此字段。

如果您的广告客户不投放欧盟政治广告，则在广告客户一级进行声明足以避免错误。如果您无法在广告客户层级进行声明，或者已声明可能会在您的广告客户下投放欧盟政治广告，则必须更新以下 API 方法的使用方式：

• 在发出 advertisers.lineItems.create 请求时，在新订单项资源中设置 containsEuPoliticalAds 字段。
• 在发出 advertisers.lineItems.duplicate 和 advertisers.lineItems.generateDefault 请求时，在请求正文中设置 containsEuPoliticalAds 字段。
• 在更新现有订单项资源的地理位置定位条件之前，请先使用 advertisers.lineItems.patch 请求设置这些资源中的 containsEuPoliticalAds 字段。地理位置定位包括以下定位类型：
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_BUSINESS_CHAIN
  • TARGETING_TYPE_REGIONAL_LOCATION_LIST
  • TARGETING_TYPE_PROXIMITY_LOCATION_LIST

结构化数据文件

在结构化数据文件中，我们推出了 v9，该版本在订单项文件中添加了 Contains EU Political Ads 列。这样，您就可以在订单项层级检索和设置欧盟政治广告声明。此列使用值 YES 和 NO 来表示订单项声明。

随着此次发布，我们还将弃用 SDF v7.1、v8 和 v8.1，并建议您尽早迁移到 v9。我们将继续支持这些版本，直到 2026 年 3 月将其停用。

自 2025 年 9 月 8 日起，Display & Video 360 将开始要求您使用 v9 上传结构化数据文件，并为新的 SDF 订单项条目将 Contains EU Political Ads 列设置为 YES 或 NO。如果您的广告客户已声明不会投放欧盟政治广告，您可以继续使用旧版本上传 SDF。

我需要做什么？

对于所创建的每个新订单项，都需要使用 Contains EU Political Ads 列提供有效的声明。

使用 Display & Video 360 API advertisers.patch 方法在广告客户中设置 containsEuPoliticalAds 字段，或在 Display & Video 360 界面中的广告客户基本详情设置下设置声明（一旦可用）。如果您声明广告客户不会投放欧盟政治广告，则新订单项将对 Contains EU Political Ads 列使用 NO 值（除非在创建时设置了其他值），并且系统会在一天内为现有订单项回填该字段。这样，您就可以使用 v7、v7.1、v8 或 v8.1 进行 SDF 上传。创建订单项后，您可以使用界面、API 或结构化数据文件更新此字段。

如果您无法在广告客户层级进行声明，或者已声明可能会在您的广告客户下投放欧盟政治广告，请在 2025 年 9 月 8 日之前执行以下操作：

• 迁移到使用 SDF v9。如需查看相关说明，请参阅我们的迁移指南。
• 在以下情况下，在上传 SDF 时将订单项条目中的 Contains EU Political Ads 列设置为 YES 或 NO：
  • 正在创建新订单项。
  • 更新现有订单项的以下任一列：
  • Geography Targeting - Include
  • Geography Targeting - Exclude
  • Geography Regional Location List Targeting - Include
  • Geography Regional Location List Targeting - Exclude
  • Proximity Targeting
  • Proximity Location List Targeting
  • 在现有订单项下创建具有一组 Geography Targeting 列的新广告组。
  • 更新现有订单项下广告组的 Geography Targeting 列。

此外，如果您使用结构化数据文件，请务必在 2026 年 3 月所有旧版本停用之前迁移到 v9。

我如何获得帮助？

如果您对此项变更还有其他疑问，请通过 Display & Video 360 API 支持渠道与我们联系。

- Trevor Mulchay，Display & Video 360 API 团队

标签： deprecation、 display-video-360-api、 structured-data-files