2026 年 4 月 22 日，星期三
今天，我们宣布推出 v24 版 Google Ads API。如需使用新的 v24 功能，您必须升级客户端库和客户端代码。所有更新后的客户端库和代码示例均已发布。
欢迎参加我们明天（美国东部时间 4 月 23 日上午 10 点）在 Discord 上举办的“Google Ads API 版本亮点”活动、Ads Developers YouTube 直播或 LinkedIn 直播活动，观看此版本的实时演示。我们还会录制活动内容并发布到 YouTube 上，方便无法参加直播活动的用户观看。如果您有任何疑问或想讨论本帖内容，请通过 Discord 上的 #ads-api 频道与我们联系。
新功能
支持含购物车数据的转化：含购物车数据的转化是转化跟踪功能的一项扩展功能，用于跟踪您网站或应用上发生的转化。借助此功能，您可以提供每笔交易所售产品的详细信息，从而为自己的 Google Ads 账号和广告系列生成销售和利润方面的高级报告并从中发掘数据洞见，例如订单数量、平均购物车内商品数量、收入和毛利润。
Google Ads API v24 增加了对该功能的支持，具体如下：
- 添加了新资源
CartDataSalesView，该资源不仅可以按产品点击细分转化指标，还可以按售出的产品细分转化指标，细分维度包括product_sold_brand。借助这些功能，广告客户可以查看客户在点击广告后实际购买的产品的统计信息，即使广告宣传的是其他产品。 - 添加了多个“所有”不可用于出价的指标，这些指标还包含您的广告系列并未以促成这些转化为目标进行积极优化的转化，例如
all_cost_of_goods_sold_micros。这些新指标会添加到支持相应可出价指标的所有资源中。 - 向
ShoppingPerformanceView资源添加了conversion_attribution_event_type细分，使其可与购物车数据和其他转化指标一起选择。此细分维度表示转化是归因于点击还是浏览，并且必须识别由浏览型转化产生的购物车数据统计信息。
功能更新
v24 版对现有功能进行了更新，升级时需要更改代码。我们在此介绍最重要的变更；如需查看完整的变更列表，请参阅版本说明。
广告系列中的视频内容排除设置：我们简化了在单个广告系列中设置视频内容排除设置的功能。此设置在客户一级提供，并会应用于所有广告系列。这些内容排除设置旨在让您进一步掌控定位设置，以便您排除虽符合我们的政策但可能不适合您的品牌或业务的内容类型。如需详细了解视频内容排除设置，请访问 https://support.google.com/google-ads/answer/7515513。
AudienceInsightsService 的变更：作为代码重构的一部分，我们将 InsightsAudience.topic_audience_combinations 请求字段移到了 common 命名空间中。在某些编程语言中，您可能需要更新导入指令。
ReachPlanService 的变更：作为代码重构的一部分，我们从 ReachPlanService.ListPlannableProducts 服务中移除了 youtube_select_lineups 字段。现在，youtube_select_lineup_targeting 字段中提供了频道组。YouTube 优选频道组是为符合条件的客户提供的预订型产品，目标受众位于 YouTube 上排名前 1% 的热门频道中，这些频道拥有特定市场中最热情的受众群体。了解详情。
ContentCreatorInsightsService 的变更：作为代码重构的一部分，我们从 ContentCreatorInsightsService.GenerateCreatorInsights 和 ContentCreatorInsightsService.GenerateTrendingInsights 服务中移除了 is_brand_connect_creator 字段。
用户应改为在 partnership_opportunities 中查找创作者是否具有 CREATOR_PARTNERSHIPS 选项。Google Ads 中的 YouTube 创作者合作中心是一个平台，可供您寻找适当的 YouTube 创作者以在其视频中投放赞助商内容，并高效管理与创作者的合作。了解详情。
KeywordPlanIdeaService 的变更：为了提供更精简、更可靠的体验，我们统一了预测基础架构。Google Ads API v24 引入了更新后的 GenerateKeywordForecastMetrics 方法，该方法专注于对效果影响最直接的指标，从而简化了规划流程。我们将在未来几天内发布一篇更详细的博文，介绍这项变更。
对 campaign_budget 资源的更改：我们移除了 campaign_budget 资源的 ad_sub_network_type 细分，因为它与此视图不兼容。
素材资源视图变更：我们从 ad_group_asset、campaign_asset 和 customer_asset 视图中移除了 click_type 细分。这项变更与最近的一项产品变更保持一致，该变更从 Google Ads 中移除了此细分，以避免数据失实。您可以使用 ad_group_ad 资源中的 click_type 细分，详细了解广告效果以及广告投放时所用的素材资源。
对自适应视频广告“VideoResponsiveAdInfo”所做的更改现在可以修改。作为此次变更的一部分，我们已将 videos、business_name 和 logo_images 标记为 DemandGenVideoResponsiveAdInfo 和 VideoResponsiveAdInfo 对象中的必填字段。
ShareablePreviewService 的变更：更新了 ShareablePreviewService.GenerateShareablePreviews，不再使用部分失败。如果请求因任何 ID 而失败，系统都会抛出错误。了解详情。
以下资源可帮助您开始使用：
如有技术支持问题，请访问 https://support.google.com/google-ads/contact/google_ads_api
- Anash P. Google Ads API 团队 Oommen
标签： google-ads-api、 release