SEO 百科

Indexing API

本页目录

Indexing API 是一个接口，由 Google 提供，作用只有两件事：通知 Google 更新某个网页，或者把它从索引里移除^[1]。发请求时要给出网页的位置，另外还能查已发通知的状态^[1]。

能用的场景很窄

这个接口只用于两类网页：一类页面要带 JobPosting 结构化数据，另一类要带 BroadcastEvent，后者嵌套在 VideoObject 里^[1]。换句话说，招聘页和带直播时间的视频页在它范围内，普通文章页不在^[1]。

发请求之前要按顺序做完四件事：为客户端创建一个项目、创建服务账号、把服务账号添加为网站所有者、获取访问令牌^[2]。

项目那一步在 Google API 控制台里做^[2]。它的作用是告知 Google 你的客户端、同时开通对这个接口的访问权限，Google 给了一个设置工具，可以直接建项目并启用^[2]。服务账号在 IAM 管理页面创建，密钥在那一步一起生成^[2]。

更新网址发一个 HTTP POST，端点是 publish 那一个^[1]。正文里给出 url 和 type，type 取 URL_UPDATED^[1]。

移除网址走同一个端点，type 换成 URL_DELETED^[1]。

查通知状态发一个 HTTP GET，用的是 metadata 端点^[1]。

端点完整形状写在这里^[1]：

https://indexing.googleapis.com/v3/urlNotifications:publish
https://indexing.googleapis.com/v3/urlNotifications/metadata

Google 的准则页列了几条硬性要求。网络垃圾政策适用于通过这个接口提交的内容^[1]。标头也有要求。所有发往 publish 端点的调用都要指定 Content-Type^[1]。这一项的值必须是 application/json。

数量上有限制。一次请求正文里只能提交一个网址，也可以按它的批量做法一次整合最多 100 个请求^[1]。这条限制的严肃性被单独点出：不得规避提交限制，例如用多个账号绕开^[1]。

这条接口与另外几条通道的分工很清楚。站点地图交的是整份地址清单，IndexNow 交的是内容变动的即时通知，网址检查工具管单个网址的重新抓取请求^[3]。Indexing API 只在招聘与直播活动这两类页面上比其他几条更直接。