Google 宣布将 Search Console Performance 报告中的三项核心功能集成至 Search Analytics API。这一更新使网站开发人员和工具制造商能够直接将相关数据整合到自动化报告系统中,简化了数据获取流程。
根据 Google 官方公告,新版 API 现已支持品牌查询过滤器、多模态网络搜索数据(webMultimodal),以及允许在单次 API 调用中同时跟踪多个国家或设备类型的过滤功能。这些功能此前已存在于 Performance 报告中,API 的更新旨在解决以往需要拼接多次请求或维护复杂关键词正则表达式的痛点。
品牌数据支持:自2026年2月21日起生效
API 结果现包含 brandedClassification 维度,支持使用 BRANDED(品牌)或 NON_BRANDED(非品牌)值对搜索数据进行筛选或分组。需注意,该维度仅提供顶级属性的数据,且数据起始时间为 2026年2月21日。若属性未达到所需的查询量和展示量阈值,API 将返回空表。
此外,品牌分类维度字段仅支持等于运算符。在已应用查询筛选器的请求中,无法再利用该维度进行额外的筛选或分组。
早在今年3月,就有用户反馈品牌数据细分仅从2月21日开始追溯。Google 的 John Mueller 随后确认,这是数据开始被追踪的时间点,此前的历史数据无法通过 API 自动拆分为品牌与非品牌类别。
多模态数据独立 API 类型上线
当搜索类型设置为 webMultimodal 时,API 将提供多模态性能指标。这涵盖了通过 Google Lens、Android“圈选搜索”以及上传图片进行的搜索行为。
尽管 Search Console 于9月24日启用了多模态报告,但当时的 API 参考文档并未列出独立的 webMultimodal 类型值。截至11月16日更新的参考文档中,该类型值已被正式列入。
值得注意的是,虽然9月的公告提到了 Chrome 浏览器的右键“搜索此图片”功能,但在最新的 API 帖子和参考文档中并未明确提及 Chrome。此外,Google 表示多模态数据未来也将通过批量数据导出功能在 BigQuery 中可用,但具体日期尚未公布。目前的批量导出表参考文档仍未包含多模态值。
支持多国或多设备单次请求过滤
新增的 filterLists 字段允许用户在单次 API 请求中,按多个国家或多个设备维度筛选结果。例如,开发者可以基于国家维度轻松构建 EMEA(欧洲、中东和非洲)、LATAM(拉丁美洲)或 DACH(德语区)等区域分组。
根据参考文档,filterLists 仅适用于国家和设备维度,且匹配方式为精确值。需特别注意,在同一请求中,不能同时在常规过滤器和 filterLists 中使用相同的维度(即国家或设备)。
关键注意事项与数据校验
品牌数据的历史局限性:符合条件的属性可从 2026年2月21日 起通过 API 获取品牌与非品牌的拆分数据。在此日期之前,API 无法区分这两类流量。由于 Google 使用 AI 辅助流程进行分类,可能存在偶发性识别错误。建议将 API 的品牌拆分数据与现有的品牌关键词正则表达式结果并行运行,以比对差异并校准数据。
多模态数据的统计重叠:截至 11月16日,API 参考文档未明确说明网页搜索结果是否已包含 webMultimodal 数据。在汇总网页和多模态总数前,务必检查 API 中的网页数据与 Performance 报告中的基于文本的多模态数据是否匹配,避免重复计算。
后续关注方向
目前,Google 尚未在帖子或 API 参考文档中说明 webMultimodal 数据的具体回溯范围。建议开发者密切关注 API 参考文档及批量导出表参考文档的更新,以获取关于 BigQuery 接入日期、多模态历史数据起始时间以及 Chrome 图片搜索支持的进一步信息。

