
谷歌正式发布 Google Ads API v10.1 版本,作为对年初 v10 版本的迭代更新。此次升级重点增强了发现广告系列、广告系列组及本地服务广告系列的支持能力,并新增了多种动态资产类型与转化追踪指标。以下为本次更新的核心内容总结:
资产与受众群体功能扩展
资产类型丰富化
- 线索表单支持通过 LeadFormSubmissionData 检索提交数据,兼容 GoogleAdsService.Search 及 SearchStream 接口。
- 新增七种动态资产类型以支持垂直行业:房地产(dynamic_real_estate_asset)、自定义资产(dynamic_custom_asset)、酒店租赁(dynamic_hotels_and_rentals_asset)、航班(dynamic_flights_asset)、旅行(dynamic_travel_asset)、本地业务(dynamic_local_asset)及职位招聘(dynamic_jobs_asset)。
- asset_group_product_group_view 新增 asset_group 和 asset_group_listing_group_filter 字段;ad_group_ad_asset_combination_view 新增 enabled 字段。
- 新增 AssetError.NAME_CONFLICT_FOR_ASSET_TYPE 错误枚举。
受众群体指标优化
- campaign_audience_view 和 ad_group_audience_view 新增 metrics.absolute_top_impression_percentage 及 metrics.top_impression_percentage 指标。
- 新增 ResourceLimitType.RULE_BASED_USER_LISTS_PER_CUSTOMER 限制类型。
- AudienceError 新增 AUDIENCE_SEGMENT_NOT_FOUND、DUPLICATE_AUDIENCE_SEGMENT、TOO_MANY_SEGMENTS 等六项错误值。
广告系列管理与批量作业
核心广告系列功能
- 全面支持 Discovery 广告系列及其广告组、广告的检索、创建与更新操作,新增对应枚举值 AdvertisingChannelType.DISCOVERY 等。
- 正式开放本地服务广告系列(Local Services Campaigns),结束测试阶段。
- 新增广告系列组(CampaignGroup)管理功能,包括 CampaignGroupService 及相关资源字段支持。
- 展示广告系列的 ListingDimensionInfo 新增 ProductGroupingInfo 等传统维度支持。
批量作业与变更历史
- BatchJobOperation 新增 remove 方法,支持移除 PENDING 状态的批量作业。
- ChangeEventResourceType 新增 ASSET_SET、ASSET_SET_ASSET 及 CAMPAIGN_ASSET_SET 资源类型。
转化追踪与关键词规划
转化数据增强
- ConversionTrackingSetting 新增 google_ads_conversion_customer 字段,用于标识转化数据管理账户。
- ClickConversion 新增 conversion_environment 字段以报告转化环境(限白名单)。
- conversion_action 新增 metrics.all_conversions_value 和 metrics.all_conversions 指标。
- 新增多项转化相关错误代码,涵盖网页订单ID缺失、客户数据条款未接受等场景。
关键词规划工具升级
- KeywordPlanIdeaService 新增 GenerateKeywordHistoricalMetrics 方法,无需关联计划或广告系列即可获取关键词历史指标。
- 新增 average_cpc_micros 字段表示平均每次点击费用,并通过 HistoricalMetricsOption.include_average_cpc 控制返回。
- GenerateKeywordIdeaResult 新增 close_variants 字段,返回紧密变体关键词列表。
报告细分与视频广告
报告字段更新
- Performance Max 和 Discovery 广告系列的 segments.click_type 现返回 CROSS_NETWORK。
- 新增 SKAdNetwork 转化细分字段:metrics.sk_ad_network_conversions 和 segments.sk_ad_network_attribution_credit。
- metrics.absolute_top_impression_percentage 和 metrics.top_impression_percentage 现已兼容 geo_target_region 及 geo_target_city 细分维度。
其他模块调整
- 视频响应式广告新增 VideoResponsiveAdInfo.breadcrumb1 和 breadcrumb2 字段。
- 酒店广告支持通过 AccountLink.hotel_center 获取 hotel_center_id。
- CriterionError 新增 CANNOT_TARGET_CUSTOMER_MATCH_USER_LIST 限制;ExperimentError 新增 STATUS_TRANSITION_INVALID 状态错误。
注:旧版 Google AdWords API 已于昨日正式下线,请开发者尽快完成迁移。

