
Google Ads API 已发布第14版重大更新,新增推荐类型、账户级否定关键词、离线转化及GA4数据支持等功能。官方表示,配套的客户端库和代码示例将于下周上线。
此次更新承接自2023年4月发布的v13.1版本。随着AdWords API于4月停用并将于7月底彻底下线,Google Ads API正加速迭代以替代旧有服务。
v13.1核心变更详解
广告系列与转化追踪升级
- 广告系列:新增 CampaignBudgetError.BUDGET_AMOUNT_MUST_BE_UNSET_FOR_CUSTOM_BUDGET_PERIOD 错误提示,规范自定义预算周期设置。
- GA4集成:ConversionActionType 新增 UNIVERSAL_ANALYTICS_GOAL、UNIVERSAL_ANALYTICS_TRANSACTION、GOOGLE_ANALYTICS_4_CUSTOM 及 GOOGLE_ANALYTICS_4_PURCHASE 枚举值,支持区分Universal Analytics与GA4导入的转化;同时新增 ConversionAction.google_analytics_4_settings 字段。
- 离线转化:新增 Customer.offline_conversion_client_summaries 用于汇总上传状态及诊断信息;在 UploadConversionAdjustments 和 UploadClickConversions 响应中增加 job_id,便于关联 OfflineConversionUploadSummary。
关键词规划与建议优化
- 规划工具重构:移除 KeywordPlanService 中的 GenerateForecastCurve 等四个预测方法,改用 KeywordPlanIdeaService.GenerateKeywordForecastMetrics,支持无需创建计划即可生成预测指标;移除 campaign_criterion_simulation 报告检索支持。
- 受众洞察:AudienceInsightsService 新增 YOUTUBE_DYNAMIC_LINEUP 维度支持;DynamicLineupAttributeMetadata 新增 sample_channels 字段,提供系列内示例频道。
- 智能建议:新增 LowerTargetRoasRecommendation(降低目标ROAS)和 RaiseTargetCpaRecommendation(提高目标CPA);ResponsiveSearchAdAssetRecommendation 新增 current_ad 字段。
条件匹配与酒店广告调整
- 否定关键词:支持对账户级否定关键词进行检索、创建和更新操作;新增 CriterionError.CANNOT_TARGET_SIMILAR_USER_LIST 错误码。
- 酒店广告:SuggestTravelAssetsRequest.place_id 字段重命名为 place_ids,适配多地点场景。
报告字段扩展
- ServedAssetFieldType 新增 SITELINK、CALL、MOBILE_APP、CALLOUT、STRUCTURED_SNIPPET、PRICE、PROMOTION、AD_IMAGE、LEAD_FORM、BUSINESS_LOGO 等枚举值,可通过 ad_group_ad_asset_view.pinned_field 获取对应资产类型。

