Google Ads API v24.1 发布

2026 年 5 月 13 日,星期三

今天,我们宣布推出 v24.1 版 Google Ads API。如需使用 v24.1 的新功能,您必须升级客户端库和客户端代码。所有更新后的客户端库和代码示例均已发布。

欢迎参加我们明天(美国东部时间 5 月 14 日上午 10 点)在 Discord 上举办的“Google Ads API 版本亮点”活动、Google Ads 开发者 YouTube 直播或 LinkedIn 直播活动,观看此版本的实时演示。我们还会录制活动内容并发布到 YouTube 上,方便无法参加直播活动的用户观看。如果您有任何疑问或想讨论本帖内容,请通过 Discord 上的 #ads-api 频道与我们联系。

新功能

移动设备平台细分:了解流量来源对于广告系列优化至关重要。在 v24.1 中,您现在可以使用 segments.mobile_device_platform 列对广告系列级和客户级报告进行细分。

此字段利用了新的 MobileDevicePlatform 枚举(支持 IOS 和 ANDROID 等值),让您能够根据用户的移动操作系统,清晰地隔离效果数据并调整出价策略。

需求开发广告系列中的传统图片:从 v24.1 开始,您可以使用 DemandGenMultiAssetAd 的 classic_display_images 字段上传静态图片广告,以便在需求开发广告系列中的 Google 展示广告网络 (GDN) 上投放。这些图片会按原样投放,不会与其他素材资源组合。此格式可让您完全掌控您的品牌创意风格。如需了解详情,请参阅我们的帮助中心。

支持通行密钥:通行密钥是一种简单又安全的登录方式,可作为密码登录的替代方法。Google 现在要求部分广告客户使用通行密钥来授权在其 Google Ads 账号中执行敏感操作。v24.1 引入了新的 passkey_enabled 字段,用于指明用户是否已启用通行密钥。

改进了对实验的支持:借助实验,您可以测试您打算做出的更改会产生什么样的影响。如果您在原始广告系列和实验之间分配预算或流量,即可轻松比较指定时间段内的结果。如果实验获得的效果更好,您可以将实验应用到原始广告系列或替换原始广告系列。

v24.1 引入了对新实验类型的支持:AI Max 实验、视频实验、需求开发广告系列实验(此实验和视频实验属于同一 API 类型)和效果最大化广告系列实验。现在,您可以检索和比较各个实验组的详细效果指标(例如点击次数、转化次数和展示次数)。这样一来,并排性能分析就会变得更简单、更透明。如需详细了解实验工作流,请参阅我们的指南。

Google Ads 将施行新数据保留政策:我们最近宣布,自 2026 年 6 月 1 日起,Google Ads 及相关效果衡量 API 将针对精细效果统计信息(每日、每小时和每周)改用 37 个月的数据保留政策。V24.1 引入了新的 DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED 错误代码,以支持此项变更。

以下资源可帮助您开始使用:

如有技术支持问题,请访问 https://support.google.com/google-ads/contact/google_ads_api

Oommen

标签: google-ads-api、 release