
Google 正式发布 Google Ads API v10.0 版本。鉴于 AdWords API 将于 2022 年 4 月 27 日停止服务,此次更新至关重要。新版本涵盖智能广告系列、Performance Max 升级、本地服务广告变更等多项核心功能。同时,Google 新增了差异页面,展示最新版本中 protos 的增删改情况,开发者可通过 GitHub 仓库查看具体变更详情。
账户管理
- 新增 Customer.status 和 CustomerClient.status 字段(类型为 CustomerStatus),用于标识账户状态。
- 扩展账户检索范围:在使用 CustomerService.ListAccessibleCustomers、GoogleAdsService.Search 及 SearchStream 时,现可获取所有类型账户,不再仅限于 ENABLED(启用)和测试账户。
广告与素材资源
广告格式调整
- Video TrueView Discovery Ad 格式更名为 In-Feed Video Ad,对应对象 VideoTrueViewDiscoveryAdInfo 重命名为 InFeedVideoAdInfo,枚举值 AdType.VIDEO_TRUEVIEW_DISCOVERY_AD 变更为 AdType.IN_FEED_VIDEO_AD。
- MutateOperation.customizer_customizer_operation 重命名为 MutateOperation.customer_customizer_operation。
素材资源优化
- 响应式搜索广告新增 ad_group_ad_asset_combination_view 支持;ad_group_ad_asset_view 新增应用预注册广告性能报告支持。
- 图像和媒体捆绑包素材资源的 name 字段设为必填。创建时若存在同名但内容不同的素材,系统将自动附加时间戳和计数器进行重命名。
- 针对图片、媒体捆绑包、文本、行动号召及 Google 图书等资产类型,若已存在名称不同但内容相同的资产,新上传资产将被静默丢弃。
- ResourceLimitType 新增 PAGE_FEED_ASSET_SETS_PER_CUSTOMER、DYNAMIC_EDUCATION_FEED_ASSET_SETS_PER_CUSTOMER 等四个资产集相关值。
- AssetError 新增 MOBILE_APP_INVALID_APP_ID、MOBILE_APP_INVALID_FINAL_URL_FOR_APP_DOWNLOAD_URL、NAME_REQUIRED_FOR_ASSET_TYPE 三个错误值。
受众群体与出价策略
受众定向增强
- 新增 Audience 资源及 AudienceService 服务,支持基于人口统计特征、用户列表及兴趣等维度创建定向受众。
- 在 GoogleAdsRow、Campaign、AdGroup 及 AdGroupCriterion 中新增 audience 或 audience_setting 字段;枚举新增 AudienceError 和 CriterionType.AUDIENCE。
出价规则变更
- 移除经理账户创建季节性调整的功能支持。
- BiddingError 新增 BIDDING_STRATEGY_AND_BUDGET_MUST_BE_ALIGNED 等三个值,强化竞价策略与预算的对齐校验。
广告系列与转化追踪
广告系列功能更新
- 智能广告系列结束公开测试,正式全面可用。
- 本地服务广告 (LSA) 进入公开测试阶段(AdvertisingChannelType 为 LOCAL_SERVICES),支持通过 Search/SearchStream 检索,并可更新状态及关联预算金额。
- Performance Max 广告系列新增资产组信号功能,帮助定位高转化人群;Smart Shopping 广告系列新增 Campaign.use_vehicle_inventory 字段。
转化追踪升级
- Customer.conversion_tracking_setting 新增 conversion_tracking_status、accepted_customer_data_terms 及 enhanced_conversions_for_leads_enabled 字段,细化转化跟踪状态与合规信息。
- ConversionAction.primary_for_goal 设为可选;ConversionValueRuleSet.attachment_type 变为不可变。
- 新增门店访问与销售相关的转化价值规则支持;ConversionActionCategory 枚举移除 LEAD,替换为 QUALIFIED_LEAD 和 CONVERTED_LEAD。
- ExternalConversionSource 新增 DISPLAY_AND_VIDEO_360_FLOODLIGHT。
实验、酒店与建议
- 实验模块:新增 ExperimentService 资源集,作为广告系列实验的新替代方案。
- 酒店广告:新增 hotel_reconciliation.campaign 及 metrics.hotel_commission_rate_micros、metrics.hotel_expected_commission_cost 指标。
- 建议模块:新增 ResponsiveSearchAdAssetRecommendation 和 UseBroadMatchKeywordRecommendation 两种建议类型。
报告与RMF规范
报告数据修正与新增
- 修复细分选择导致零指标行返回不一致的问题,统一忽略无指标数据的行。
- 新增 omit_unselected_resource_names 元参数,设为 true 时仅返回 SELECT 子句中明确请求的资源字段。
- Campaign.start_date 和 end_date 日期格式统一基于客户时区,不再受经理账户时区影响。
- geographic_view 及 segments.hour 新增 absolute_top_impression_percentage 和 top_impression_percentage 指标。
- SKAdNetwork 转化数据新增 user_type、ad_event_type 及 source_app_id 细分字段;新增 biddable_app_install_conversions 和 biddable_app_post_install_conversions 指标。
RMF要求更新
- Performance Max 和智能广告系列新增 RMF 要求。同步记录购物、酒店及应用广告系列的最低功能标准,并简化标准购物广告系列以与服务型广告系列保持一致。

