Google 在 9 月 9 日更新了 Web Search Service API 的公开开发者文档。这个 API 能返回全网搜索结果,但调用方除了 Google Cloud 项目和 API key,还必须持有合作协议对应的 client ID。与此同时,面向所有开发者的 Custom Search JSON API 已停止接收新客户,2027 年 1 月 1 日停止服务。
关键信息
- 生效时间:文档更新在 9 月 9 日;Custom Search JSON API 与超过 50 个域名的 Programmable Search Element 都在 2027 年 1 月 1 日截止
- 影响谁:站内搜索用了 Google 可编程搜索的网站,以及任何用 Custom Search JSON API 做排名监控 / 数据抓取的工具和脚本
- 要不要动:要动。年底前把站内搜索和自建脚本的依赖查一遍,留出迁移时间
发生了什么
按 Search Engine Journal 的梳理,文档主页加四个相关页面在 9 月 9 日一起更新。API 只有一个主方法 Search,参考页把它描述为执行「full web search」,通过 REST 或 gRPC 返回 JSON。每次请求必须带合作伙伴 client ID、用户 IP 和查询词——带 IP 是为了区域路由,也用于防滥用。单次最多返回 20 条结果、默认 10 条,可以用 token 翻页;支持按语言、国家、时间范围过滤,开 SafeSearch,或按日期排序;响应字段包括标题、URL、摘要、MIME 类型、文件格式、预估结果总数,以及 Google 建议的纠错查询。文档把调用方称为「programmatic partners」,但没有写怎么成为合作伙伴、多少钱、有什么配额。背景是今年 1 月 Google 宣布 Programmable Search Element 转向 50 个域名以内的站内搜索,企业级的对话式搜索和 grounding 需求引导到 Vertex AI Search,需要「整个索引」的走单独的全网方案并填表申请。截至 9 月 11 日,1 月那篇公告和这次更新的文档互相没有提及对方。
对独立站卖家意味着什么
有两件事要分开看。第一件是实际要动手的:如果你的站内搜索框是用 Google 可编程搜索(Programmable Search Engine / CSE)实现的——WordPress 站点里这种做法很常见,不少主题和插件默认就集成了——只要检索范围超过 50 个域名或是全网检索,2027 年 1 月 1 日之后就会断。自建站通常只搜自己一个域名,属于 50 个以内、不受影响,但值得现在就确认一遍配置,顺便看看有没有旧脚本还在调 Custom Search JSON API 做排名抓取或竞品监控,那条路是确定要关的。年底前查,不要留到 12 月。第二件是趋势判断:Google 把全网索引的程序化访问变成了合同准入,这意味着能拿到 Google 全量结果的第三方越来越少。对卖家的间接影响是排名工具的数据来源和价格可能变动,以及各家 AI 产品的检索底座会更快地分化——有的用 Google,有的用自己的爬虫,同一个问题在不同 AI 里给出的引用来源会越差越远。这一条暂时不用做什么,但可以解释你未来在不同工具里看到的数字为什么对不上。