
Google Ads API 正式发布第18版,这是该接口的一次重大版本更新。新版在账户管理、广告组、资产、广告系列、酒店旅游、本地服务、Performance Max(PMax)、规划及报告等核心模块均进行了功能升级与优化。
账户管理与广告组更新
- 创作者视频链接:新增 DataLinkService.CreateDataLink(仅限白名单账户),支持将 Google Ads 账户关联至 YouTube 创作者频道视频,便于投放合作广告。
- 人口统计排除扩展:AdGroup.exclude_demographic_expansion 字段允许在开启优化目标定位时,排除特定人口统计特征的扩展,该功能此前仅适用于需求生成广告。
广告与资产管理优化
广告功能增强
- 自动资产控制:新增 AdGroupAd.ad_group_ad_asset_automation_settings,支持手动选择加入或退出自动资产生成。
- 新增自动化类型:AssetAutomationType 增加 GENERATE_VERTICAL_YOUTUBE_VIDEOS 和 GENERATE_SHORTER_YOUTUBE_VIDEOS 选项。
- 自有渠道投放:新增 AdNetworkType.GOOGLE_OWNED_CHANNELS,专门用于标识在 YouTube、Gmail 及 Discover 信息流等 Google 自有渠道的投放。
资产命名规范
- AssetType.DISCOVERY_CAROUSEL_CARD 已重命名为 AssetType.DEMAND_GEN_CAROUSEL_CARD,以统一需求生成广告的术语体系。
广告系列指标与设置调整
- 门店访问归因:新增 metrics.store_visits_last_click_model_attributed_conversions 指标,追踪最后点击模型下的门店访问量。
- 视频观看指标:补充了信息流、直播及 Shorts 场景下的视频观看率指标(metrics.video_view_rate_shorts 等)。
- 转化购买数据:新增 metrics.results_conversions_purchase,用于返回统一目标下的转化购买详情。
- 默认设置变更:DemandGenCampaignSettings.upgraded_targeting 默认值由 false 调整为 true。
内容定位与酒店旅游专项更新
内容定向视图
- 新增 content_criterion_view,支持查询展示广告、需求生成及视频广告中基于关键词、版位和主题的内容性能指标。
酒店与旅游生态
- 旅游信息流支持:搜索广告现支持旅游信息流,新增 ClickType.TRAVEL_ASSETS 及 AssetSetType.TRAVEL_FEED 以便细分指标和管理信息流开关。
- 行程转化规则:(仅限白名单)新增 travel itinerary 转化价值规则,支持按提前预订窗口、行程长度及出发星期几设定条件。
- 目的地细分:报告新增 segments.travel_destination_city/country/region 维度,支持按城市、国家及区域细分酒店和搜索广告表现。
本地服务与Performance Max升级
本地服务改进
- 录音URL处理:当无通话录音时,PhoneCallDetails.call_recording_url 返回空值而非无效链接。
- 类别出价:新增 CategoryBid.target_cpa_bid_micro,支持通过 Campaign.local_services_campaign_settings 为特定类别设置目标 CPA。
Performance Max品牌指南
- 品牌素材绑定:启用品牌指南(brand_guidelines_enabled)后,BUSINESS_NAME、LOGO 等素材必须作为 CampaignAsset 而非 AssetGroupAsset 链接。
- 错误校验机制:新增 REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED 等错误码;若未启用品牌指南却尝试以 CampaignAsset 链接品牌素材,或未启用时以 AssetGroupAsset 链接,系统将抛出对应 AssetLinkError。
- 展示位置洞察:新增 performance_max_placement_view,可查询 PMax 广告的具体展示位置印象数。
规划工具与推荐系统迭代
创作者与受众洞察
- 创作者洞察:(仅限白名单)新增 ContentCreatorInsightsService.GenerateCreatorInsights,支持按受众/内容组合或频道 ID 探索顶级 YouTube 创作者数据。
- AI 辅助定位:AudienceInsightsService 支持通过自由文本描述生成定位建议,并新增 GenerateTargetingSuggestionMetrics 服务以评估潜在触达效果。
预算优化推荐
- RecommendationService.GenerateRecommendations 新增 CAMPAIGN_BUDGET 推荐类型,可在构建 Performance Max 和 Search 广告系列时提供预算优化建议。
报告查询与配额管理
- 搜索设置重构:SearchGoogleAdsRequest 中的 summary_row_setting 和 return_total_results_count 字段已被 search_settings 替代,包含 omit_results、return_summary_row 及 return_total_results_count 子字段。
- 无效点击监测:新增“无效点击总数”与“无效点击率”指标,用于识别机器人或异常模式产生的点击。
- 配额错误细化:新增“短期查询资源过度消耗”和“长期查询资源过度消耗”错误类型,便于开发者排查 API 调用限制问题。

