
Google 正式发布 Google Ads API v23.1 次要版本更新。此次升级涵盖账户管理、广告系列配置、转化追踪、激励措施、规划工具及报告指标等多个核心模块,旨在提升广告投放的精准度与合规性。
官方提示,使用 v23.1 新功能需同步升级客户端库及代码。同时,为适配欧盟政治广告法规,v20.2、v21.1 和 v22.1 版本也已发布相应支持补丁。值得注意的是,旧版 AdWords API 已于今年4月停用,并将于7月底彻底停止服务,建议开发者尽快完成迁移。
账户管理与合规声明
- 合作伙伴域名限制:ProductLinkInvitation 和 ProductLink 资源新增 advertising_partner_properties.allowed_domain 字段,用于限定广告合作伙伴仅可在指定域名内进行投放。
- 欧盟政治广告标识:Customer 资源新增 contains_eu_political_advertising 字段,返回 EuPoliticalAdvertisingStatusEnum 枚举值,用于检索账户是否包含针对欧盟的政治广告声明状态。
广告系列与素材控制
- AI文本素材管控:Campaign 资源新增 text_guidelines 字段,支持通过 term_exclusions(术语排除)和 messaging_restrictions(消息限制)编程控制 Performance Max 及搜索广告中 AI 生成文本的内容规范。
- 预订状态原因扩展:针对 FIXED_CPM 出价策略,新增 CAMPAIGN_NOT_BOOKED、BOOKING_HOLD_EXPIRING、BOOKING_HOLD_EXPIRED 及 BOOKING_CANCELLED 四种主要状态原因,便于排查预订问题。
- 视频广告设置:Campaign.VideoCampaignSettings 新增 reservation_ad_category_self_disclosure 及只读字段 booking_details。
- 合规查询筛选:新增 Campaign.missing_eu_political_advertising_declaration 字段,支持快速筛选缺失欧盟政治广告声明的广告系列。
转化追踪与定向规则
- YouTube 后续观看追踪:ConversionActionCategory 新增 YOUTUBE_FOLLOW_ON_VIEWS,用于统计观看广告后继续浏览同一频道其他视频的用户行为。
- 人口统计定向校验:CriterionErrorEnum 新增 CANNOT_TARGET_ONLY_UNDETERMINED 错误码,禁止将目标受众仅设定为“未确定”类别。
规划工具与报告指标
- 基准数据细分:GenerateBenchmarksMetrics 通过 BreakdownDefinition 新增对日期维度的细分支持。
- 展示位置扩展:ReachPlanService.GenerateReachForecast 将 GOOGLE_DISPLAY_NETWORK 纳入 Demand Gen Max Conversions 的可定向展示位置。
- 趋势洞察增强:GenerateTrendingInsights 在 TrendInsightDataPoint 中新增历史趋势线信息,辅助按主题分析市场动向。
- 频次覆盖指标:报告系统新增 unique_users_two_plus 至 unique_users_ten_plus 系列指标,分别统计被广告触达2次及以上、3次及以上直至10次及以上的唯一用户数。
- 垂直行业数据源:SearchTermMatchSourceEnum 新增 VERTICAL_ADS_DATA_FEED,支持旅游等垂直行业的实体定向匹配。
激励措施与视频上传服务
- 激励兑换校验:IncentiveErrorEnum 新增 MAX_INCENTIVES_REDEEMED 和 ACCOUNT_TOO_OLD 两个错误代码,自2026年3月11日起生效,用于处理超额兑换或账户资格不符的情况。
- YouTube 视频上传API:新增 YouTubeVideoUpload 服务及对应资源,支持程序化上传及管理视频、获取上传状态与元数据。目前该功能仅限 REST 和 Python 客户端库调用。

