
Google Ads API 13.0 版本现已正式发布。本次更新重点支持面向旅游目标的 Performance Max 广告系列及基于规则的用户列表再营销功能,同时涵盖账户管理、素材资源、转化追踪等多个模块的优化。随着 AdWords API 于 4 月停用并将于 7 月底彻底停止运行,建议开发者尽快完成迁移适配。
账户管理与素材资源
- 产品链接管理:新增 ProductLinkService,支持在 Google Ads 账户与其他产品间建立或移除链接(当前仅支持 Customer Match 数据合作伙伴),功能对标用户界面中的“关联账户”视图。
- 素材迁移与状态追踪:Customer 对象新增 location_asset_auto_migration_done 等字段,用于跟踪位置和图像素材资源的自动迁移状态;CustomerAsset、CampaignAsset 及 AdGroupAsset 新增 primary_status 及其详情字段,便于监控素材审核状态。
- 策略与类型扩展:Asset 对象新增 field_type_policy_summaries 字段返回策略摘要;支持 BUSINESS_LOGO 资产类型,并允许 CampaignAsset.field_type 设置为 BUSINESS_NAME 和 BUSINESS_LOGO。
- 错误枚举更新:AdGroupError 与 CampaignError 新增 INVALID_EXCLUDED_PARENT_ASSET_SET_TYPE;AssetSetError 新增 OAUTH_INFO_INVALID、OAUTH_INFO_MISSING 及 CANNOT_DELETE_AS_ENABLED_LINKAGES_EXIST 等校验错误。
受众群体与批量作业
- 规则用户列表重构:RuleBasedUserListInfo 中已移除 CombinedRuleUserListInfo 和 ExpressionRuleUserListInfo,请统一迁移至 FlexibleUserListInfo。
- 线索表单资格验证:新增 QualifyingQuestion 相关字段,支持获取线索表单资产中资格问题的详细信息,确保问题在投放前通过审核。
- 批量作业超时控制:BatchJobMetadata 新增 execution_limit_seconds 字段,明确批量作业执行时间上限,超时将自动取消任务。
计费与广告系列设置
- 计费异常反馈:新增 InvalidActivitySummary 以提供发票无效活动的详细原因;AccountBudgetProposalError 新增 CANCELED_BILLING_SETUP 枚举值。
- 智能广告系列状态查询:新增 SmartCampaignSettingService.GetSmartCampaignStatus 方法,提供更聚合的智能广告系列资产状态视图,建议优先使用该方法替代 Campaign.primary_status 等传统字段。
- 定向优化升级:AdGroup.explorer_auto_optimizer_setting 被 optimized_targeting_enabled 取代,支持 DISPLAY、VIDEO、DISCOVERY 渠道的优化定向(限白名单客户)。
- CampaignError 扩充:新增包括 AVERAGE_DAILY_SPEND_TOO_HIGH、CANNOT_ATTACH_TO_REMOVED_CAMPAIGN_GROUP、NOT_ENOUGH_CONVERSIONS 等在内的多项预算、草稿及转化操作相关的错误枚举。
转化追踪与条件设置
- 上传校验增强:未接受客户数据条款时上传含 user_identifiers 的点击转化将报错 CUSTOMER_NOT_ACCEPT_CUSTOMER_DATA_TERMS;重复上传相同 gbraid 组合将返回 CLICK_CONVERSION_ALREADY_EXISTS;未正确配置潜在客户高级转化功能将返回 CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS。
- 无代码转化支持:新增 ConversionActionType.WEBPAGE_CODELESS,标识从网站事件直接创建的转化行为。
- 本地服务广告系列:CampaignCriterion 新增 local_service_id 字段,支持添加或移除特定服务;若移除最后一个有效服务 ID 或使用无效类别 ID,系统将返回相应错误提示。
酒店旅游与视频广告
- 旅游 Performance Max:新增 HotelPropertyData、HotelPropertyAsset 等资源及 HOTEL_PROPERTY 枚举类型,全面支持以旅行为目标的 Performance Max 广告系列。
- 旅游资产与活动支持:白名单客户可使用 TravelAssetSuggestionService 自动生成图片及文案资产;同时新增对“活动”广告系列的全链路支持,包括创建、报告及 travel_performance_view 等资源。
- 视频贴片广告优化:VideoBumperInStreamAdInfo 新增 action_button_label 和 action_headline 行动号召字段;TargetCpm 出价策略新增 target_frequency_goal 以支持频次目标设定。
- 频道与版位扩展:新增 VIDEO_REACH_TARGET_FREQUENCY 子频道类型及 GOOGLE_PRODUCTS 展示位置类型;AdGroupBidModifier 中已移除 PreferredContentInfo。
推荐系统与购物广告
- 推荐逻辑迭代:基于 Feed 的扩展推荐已全面替换为基于资产的推荐(如 call_extension_recommendation 变更为 call_asset_recommendation);Recommendation 对象新增 campaigns 字段显示适用广告系列,并移除 ResponsiveSearchAdAssetRecommendation.current_ad。
- 购物性能视图:ProductBiddingCategoryInfo 移除 country_code 字段;shopping_performance_view 新增对 segments.product_feed_label 的支持,提升数据细分能力。
错误代码变更说明
自 v13 版本起,部分字段在执行无效操作时返回的错误代码已进行调整,开发过程中请注意查阅最新文档以确保异常处理逻辑的准确性。

