Google Ads API v23 发布公告

2026 年 1 月 28 日，星期三

今天，我们宣布推出 v23 版 Google Ads API。这是 2026 年的第一个版本，也标志着我们开始加快发布节奏。

如需使用 v23 的某些功能，您必须升级客户端库和客户端代码。所有更新后的客户端库和代码示例均已发布。

以下是此版本中的一些主要功能：

• 为效果最大化广告系列启用了广告联盟类型细分。
• InvoiceService.ListInvoices 现在可以在 Invoice 中返回更精细的详细信息，包括广告系列级费用明细、分项监管费用和调整信息。如需获取这些详细信息，请在 ListInvoicesRequest 中设置 include_granular_level_invoice_details。
• 现在，您可以为某些广告系列类型指定开始时间和结束时间。新字段 Campaign.start_date_time 和 Campaign.end_date_time 分别取代了 Campaign.start_date 和 Campaign.end_date。
• 现在，您可以在 PerStoreView 中查看实体店位置详情。您可以通过 API 检索“商店”报告中显示的商店位置列。
• 添加了新的 LIFE_EVENT_USER_INTEREST 维度。这样，用户就可以使用AudienceInsightsService和ContentCreatorInsightsService中的“人生大事”来构建受众群体。
• ReachPlanService.GenerateConversionRates 响应现在包含展示位置，可根据展示位置控件（例如 Gmail、Shorts）提供不同的转化率建议。此功能仅适用于需求开发广告系列。
• 添加了新的 AudienceInsightsService.GenerateAudienceDefinition 方法，可让您使用生成式 AI 将目标受众群体的自由文本描述转换为匹配的受众群体属性。
• ShoppingPerformanceView 现在支持按转化日期细分的新竞争指标和转化指标。

在哪里可以获得更多信息？

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

• 版本说明
• 从先前版本升级
• 指南
• 参考文档
• v23 与 v22 之间的差异

欢迎参加我们于美国东部时间 1 月 29 日上午 11 点在 Discord 上举办的“Google Ads API 版本亮点”活动，了解此版本的详细信息。如果您有任何疑问或想讨论此帖子，请在 #ads-api 频道中与我们联系。

如有技术支持问题，请访问 https://support.google.com/google-ads/gethelp

 - Anash P. Google Ads API 团队 Oommen

标签： google-ads-api、 release