
Google Ads API v21 正式发布,本次更新涵盖搜索广告 AI Max、Performance Max 优化、欧盟政治广告合规及多项报告与素材功能升级。开发者需注意,AdWords API 已于今年 4 月停用,并将于 7 月底彻底停止运行,请尽快完成迁移。
搜索广告 AI Max 全面升级
- 启用与控制:支持通过 Campaign.ai_max_setting.enable_ai_max 字段为搜索广告系列启用 AI Max。该功能通过搜索词匹配扩大覆盖范围,同时允许在设置时保留定向和创意控制。若未启用 AI Max 而选择 FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION,系统将抛出 CampaignError.AI_MAX_MUST_BE_ENABLED 错误。
- 广告组级定向:新增广告组级别定向控制,支持添加品牌列表、地理位置及网页(URL 规则)条件。可通过 AdGroup.ai_max_ad_group_setting.disable_search_term_matching 禁用特定广告组的搜索词匹配。
- 数据报告:新增 ai_max_search_term_ad_combination_view,用于追踪搜索词、标题与着陆页组合的性能表现。search_term_match_type 分段新增 AI_MAX 值。
素材与资产管理优化
- PromotionAsset 扩展:新增条款文本(terms_and_conditions_text)、URI、条形码及二维码信息字段,丰富促销素材展示维度。
- 自动化资产控制:AssetAutomationTypeEnum 新增 FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION,支持从最终 URL 自动生成文本资产和落地页;新增 AutomaticallyCreatedAssetRemovalService,允许移除自动创建的最终 URL 扩展资产。
- 枚举修正:ServedAssetFieldType 新增 DESCRIPTION_PREFIX,修复 ad_group_ad_asset_combination_view 中描述前缀资产显示为 UNKNOWN 的问题。
广告系列配置与出价策略更新
- 位置定位限制:CampaignPrimaryStatusReason 新增 MISSING_LOCATION_TARGETING,针对未指定位置的位置受限广告系列返回状态提示;在允许区域外添加定位将触发 LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN 错误。
- 第三方集成与排除:Campaign 及 VideoCustomer 层级支持 third_party_integration_partners;现有广告系列可直接设置 advertising_partner_ids;支持通过经理账户共享列表在客户账户中批量排除展示位。
- 出价策略增强:MaximizeConversionValue 和 TargetRoas 策略新增 target_roas_tolerance_percent_millis 字段,仅适用于搜索广告系列的投资组合策略。
- 资源与错误码:新增 LocationInterestView 汇总位置兴趣表现;ProductGroup 部分失败请求的错误码变更为 LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION。
转化追踪与需求生成调整
- 转化归因:conversion_attribution_event_type 新增 ENGAGED_VIEW 分段值;ConversionUploadService 不再支持 debug_enabled 模式。
- 预算下限:Demand Gen 广告系列新增 BUDGET_BELOW_DAILY_MINIMUM 错误代码,当预算低于最低限额时触发,详情可参考 budgetDailyMinimumErrorDetails。
欧盟政治广告合规要求
本变更已同步至 v19.2 和 v20.1 版本,v21 进一步强化执行:
- 自我声明必填:创建新广告系列必须设置 contains_eu_political_advertising 字段,否则返回 REQUIRED 错误。若标记为 CONTAINS_EU_POLITICAL_ADVERTISING,自 2025 年 9 月 22 日起将在欧盟停投。
- 定向修改限制:未完成自我声明的现有广告系列,在修改地理或位置定向时将触发 MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION 错误。
- 实验广告:Trials and Experiments 同样强制执行上述自我声明检查。
Performance Max 与规划工具迭代
- PMax 默认设置:新建 PMax 广告系列的 brand_guidelines_enabled 默认值设为 true。
- 搜索词报告:新增 campaign_search_term_view,支持 PMax 广告系列层级的搜索词指标聚合;search_term_match_type 新增 PERFORMANCE_MAX 值。
- ReachPlan 增强:ListPlannableUserInterests 支持查询用户兴趣名称与路径;ListPlannableUserLists 新增 AdditionalApplicationInfo 可选输入。
- AudienceInsights 升级:支持一方用户列表获取受众洞察与触达建议;TrendInsightMetrics 新增受众份额指标;KnowledgeGraphAttributeMetadata 新增相关类别筛选。
报告视图与视频广告新功能
- 报告指标完善:AssetGroupAsset 等视图新增多项指标,PMax 展示量恢复真实值;支持按 ChangeStatus 筛选 AssetSet 资源;新增 final_url_expansion_asset_view、landing_page_source 段及 search_term_targeting_status 等细分维度。
- YouTube 视频资产:新增 YouTubeVideoListAsset 及相关链接字段;公开 VIDEO_RELATED_VIDEOS_CLICK 等新点击类型。
- 视频投放控制:VideoAdInventoryControl 新增 allow_non_skippable_in_stream,支持不可跳过前贴片混合投放;新增视频广告序列只读字段。
- 白名单功能:CampaignCriterion 和 AdGroupCriterion 新增 VIDEO_LINEUP 标准类型,仅限白名单账户使用。
- 内容适宜性:新增明细与分组层级的内容适宜性报告。

