宣布发布 v5 版本，并为支持欧盟政治广告法规而在 Campaign Manager 360 API 中进行变更

2025 年 9 月 2 日，星期二

有何变化？

正如我们去年宣布的那样，Google 将在 2025 年 10 月新法规生效之前停止在欧盟投放政治广告。今天，我们将发布 Campaign Manager 360 API v4 的更新，以支持此项变更。我们还宣布发布 v5。

如需详细了解与 euPoliticalAdsDeclaration 相关的变更，请继续阅读本文。如需详细了解所有其他变更以及 v5 版本，请参阅版本说明。

v4 弃用和停用提醒

根据我们的弃用时间表，v5 版本的发布标志着 v4 弃用期的开始，v4 将于 2026 年 2 月 26 日停用。在此日期之后，针对 v4 发出的任何请求都将开始返回错误。

如需了解详情，请参阅迁移指南。在大多数情况下，您只需升级到首选客户端库的最新版本。我们建议您查看版本说明，了解您可能需要注意的重要变更。

如果您对此或 Campaign Manager 360 API 的其他方面有任何疑问，欢迎随时通过我们的支持论坛与我们联系。

背景

Campaign Manager 360 将要求针对欧盟政治广告自行做出声明。创建广告系列时，您必须声明该广告系列是否包含欧盟政治广告。

您也可以为整个广告客户进行此声明。此声明将说明该广告客户名下的任何广告系列是否会包含欧盟政治广告。我们建议您使用 Campaign Manager 360 API 或在 Campaign Manager 360 界面的广告客户属性设置下，在广告客户一级进行声明。

Campaign Manager 360 API v4 和 v5 将支持声明广告系列是否包含欧盟政治广告。

Campaign Manager 360 API

Campaign Manager 360 将开始要求为新广告系列以及现有广告系列（在添加新展示位置、广告或广告素材时）提供声明。

Campaign Manager 360 API v5 将要求为新的广告系列资源以及在添加新的展示位置、广告或广告素材时的现有广告系列资源提供 euPoliticalAdsDeclaration 字段。

euPoliticalAdsDeclaration 字段将添加到 v4 和 v5 中的以下 API 对象，以便在不同的资源级别显示自我声明：

  • Campaign 对象，用于在广告系列一级获取和设置声明。
  • Advertiser，用于在广告客户层级获取和设置声明。

下表列出了可为广告客户资源上的此字段设置的值。

值
ADVERTISER_PLANS_TO_SERVE_EU_POLITICAL_ADS
ADVERTISER_DOES_NOT_PLAN_TO_SERVE_EU_POLITICAL_ADS

下表列出了可为 Campaign 资源上的此字段设置的值。

值
CONTAINS_EU_POLITICAL_ADS
DOES_NOT_CONTAIN_EU_POLITICAL_ADS

如果您将父级广告客户的 euPoliticalAdsDeclaration 字段设置为 ADVERTISER_DOES_NOT_PLAN_TO_SERVE_EU_POLITICAL_ADS，则系统会回填现有广告系列的该字段以使其匹配，并且新广告系列将使用该值（除非在创建时设置了其他值）。

我需要做什么？

我们建议您在广告客户一级进行声明。为此，您可以在调用 advertisers.insert、 advertisers.patch 或 advertisers.update 方法时使用 API 设置 euPoliticalAdsDeclaration 字段，也可以在 Campaign Manager 360 界面的广告客户属性设置下进行设置。

如果您无法在广告客户层级进行声明，或者已声明可能会在广告客户层级投放欧盟政治广告，则需要通过更新以下 API 方法的使用方式，在广告系列层级提供声明：

这对我的广告系列投放有何影响？

如需详细了解此声明对广告投放有何影响，请参阅 Campaign Manager 360 帮助中心文章。

了解详情

与 Campaign Manager 360 API 的每个新版本一样，我们建议您仔细查看版本说明中的所有变更。如果您想立即开始使用，现在可以获取更新后的客户端库。如果您刚开始使用，入门指南是一份很好的参考资料，可帮助您快速上手。

欢迎试用，如有任何疑问，请告诉我们！

作者肖像 - Kamlesh，Campaign Manager 360 API 团队

标签： campaign-manager-360-api、 release