
Google 近日发布 Google Ads API v14.1 次要更新版本,距 v14 上线仅约两个月。此次更新新增了推荐类型及搜索词洞察支持等功能。值得注意的是,随着 AdWords API 于 4 月停用并将于 7 月底彻底下线,建议开发者尽快完成迁移适配。
账户管理与计费优化
- Customer.customer_agreement_setting:新增字段用于标识客户是否已接受潜在客户表单服务条款。
- Invoice 与 AccountSummary:新增 export_charge_subtotal_amount_micros、export_charge_tax_amount_micros 及 export_charge_total_amount_micros 字段,完善出口费用明细展示。
素材资源与广告系列增强
素材状态与行动号召
- AssetGroup 及 AssetGroupAsset:新增 primary_status、primary_status_reasons 等字段,明确素材组投放状态及受限原因。
- CallToActionType 枚举:新增 BUY_NOW、DONATE_NOW、ORDER_NOW、PLAY_NOW、SEE_MORE、START_NOW、VISIT_SITE、WATCH_NOW 等选项。
- AssetLinkError 枚举:新增 CUSTOMER_NOT_VERIFIED、UNSUPPORTED_CALL_TO_ACTION、PAGE_FEED_INVALID_LABEL_TEXT 错误类型。
广告系列与限定条件
- CampaignPrimaryStatusReason 枚举:新增 HAS_ASSET_GROUPS_DISAPPROVED、HAS_ASSET_GROUPS_LIMITED_BY_POLICY、MOST_ASSET_GROUPS_UNDER_REVIEW 状态值。
- Discovery 广告系列(白名单):支持通过 upgraded_targeting 将位置和语言设为广告组限定条件;新增 LanguageInfo 和 LocationInfo 作为 AdGroupCriterion。
- CriterionError 枚举:新增 INVALID_DETAILED_DEMOGRAPHIC 错误值。
Performance Max 智能推荐
系统新增三类针对 Performance Max 的优化建议:
- PerformanceMaxOptInRecommendation:建议在账户中创建首个 PMax 广告系列。
- ImprovePerformanceMaxAdStrengthRecommendation:建议提升资产组强度以优化效果。
- MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation:建议将动态搜索广告系列迁移至 PMax。
数据报告与购物视频功能
客户价值与搜索洞察
- 新增 metrics.new_customer_lifetime_value、metrics.all_new_customer_lifetime_value 指标及 segments.new_versus_returning_customers 细分维度。
- search_term_insight 视图新增 metrics.search_volume,展示搜索词类别的搜索量范围。
购物与视频广告
- 商品列表:ListingGroupInfo 与 AssetGroupListingGroupFilter 新增 path 字段;ShoppingSetting 新增 advertising_partner_ids 字段。
- CampaignError 枚举:新增 NOT_LINKED_ADVERTISING_PARTNER 及 INVALID_NUMBER_OF_ADVERTISING_PARTNER_IDS 错误值。
- 视频广告(白名单):支持 AdType.DISCOVERY_VIDEO_RESPONSIVE_AD 及其对应信息对象。
实验管理错误码更新
ExperimentError 枚举新增以下错误值,便于排查实验配置问题:
- DUPLICATE_EXPERIMENT_CAMPAIGN_NAME:实验广告系列名称重复。
- CANNOT_REMOVE_IN_CREATION_EXPERIMENT:无法移除创建中的实验。
- CANNOT_ADD_CAMPAIGN_WITH_DEPRECATED_AD_TYPES:禁止添加包含已弃用广告类型的广告系列。

