
Google正式发布Google Ads API v24版本。作为包含数十项更新的主要版本,v24重点优化了需求生成(Demand Gen)、旅游信息流、转化类型、购物广告、视频及报告等核心模块的功能与数据结构。
广告与素材资源更新
在广告对象方面,DemandGenVideoResponsiveAdInfo 中的 videos 和 logo_images 字段,以及 VideoResponsiveAdInfo 中的 videos、business_name 和 logo_images 字段现已设为必填项。同时,VideoResponsiveAdInfo 对象已支持可变操作。
素材资源层面,AssetSet 新增 travel_feed_data 只读字段。该字段允许从旅游信息流素材资源集中读取数据,包括酒店中心账户ID、商户中心ID、合作伙伴中心ID、子集ID及旅游信息流垂直类型等关键信息。
广告系列与转化功能调整
广告系列配置变更
- 移除
Campaign.video_brand_safety_suitability字段,相关控制功能迁移至客户级别(Customer.video_brand_safety_suitability)。 - 新增
Campaign.view_through_conversion_optimization_enabled字段(默认值为false),支持在需求生成及应用广告系列中启用浏览转化(VTC)优化。 - Performance Max广告系列全面开放性别排除功能,适用于所有API版本。
转化类型与用户列表
- 新增对Lead Gen转化类型的支持,引入新的
ConversionActionType枚举值。 - 移除
LOYALTY_SIGN_UPS用户列表客户类型类别。 - 常规错误处理中新增
UserListErrorEnum.DUPLICATE_LOOKALIKE,用于标识尝试创建与现有列表完全相同的类似受众时的重复错误。
规划服务与报告体系升级
规划服务破坏性变更
InsightsAudience.topic_audience_combinations类型定义变更为common.InsightsAudienceAttributeGroup,强类型客户端库需同步更新集成代码。ReachPlanService.ListPlannableProducts移除youtube_select_lineups字段,请改用youtube_select_lineup_targeting获取阵容信息;响应中新增ProductCoreAttributes字段以提供更详细的产品属性。ContentCreatorInsightsService移除is_brand_connect_creator字段,建议通过检查partnership_opportunities中是否包含CREATOR_PARTNERSHIPS选项来替代。KeywordPlanIdeaService.GenerateKeywordForecastMetrics移除多个旧有字段。
报告维度与指标扩展
- 移除
campaign_budget资源的ad_sub_network_type细分维度,以及AdGroupAsset、CampaignAsset和CustomerAsset视图中的click_type细分维度。 - 新增
CartDataSalesView资源,支持按实际销售产品(如product_sold_brand)而非仅按点击产品细分转化指标。 - 引入不可竞价指标(non-biddable metrics),例如
all_cost_of_goods_sold_micros,涵盖未积极优化的转化数据,并添加至所有支持对应可竞价指标的资源中。 ShoppingPerformanceView资源新增conversion_attribution_event_type细分维度。
购物与视频服务优化
购物广告方面,ShoppingProduct 资源新增对应用广告系列的支持(注:不支持 status 和 issues 字段)。同时,Shopping Campaigns 引入基于逻辑表达式的标签产品过滤功能,提升投放精准度。
视频服务中,ShareablePreviewService.GenerateShareablePreviews 不再使用部分失败机制,若请求中任一ID失败将直接抛出错误。此外,返回的资产组错误代码已与广告组广告错误标准保持一致。

