Google Indexing API
来源:https://developers.google.com/search/apis/indexing-api/v3/quickstart
概述
Google Indexing API 允许网站所有者直接通知 Google 关于页面的新增或删除,从而加速 Google 对页面变更的感知和处理。该 API 目前仅支持包含 JobPosting(职位发布)或 BroadcastEvent(嵌入 VideoObject 的直播事件)结构化数据的页面。
核心功能
四项核心操作
| 操作 | 说明 |
|---|---|
| 更新 URL | 通知 Google 有新增 URL 或已有页面内容已更新 |
| 删除 URL | 告知 Google 某个页面已从服务器删除 |
| 查询请求状态 | 检查 Google 最后一次接收特定 URL 通知的时间 |
| 批量请求 | 在单次 HTTP 请求中合并最多 100 个 API 调用 |
API 端点
POST https://indexing.googleapis.com/v3/urlNotifications:publish
请求示例
更新 URL:
{
"url": "https://example.com/jobs/123",
"type": "URL_UPDATED"
}
删除 URL:
{
"url": "https://example.com/jobs/123",
"type": "URL_DELETED"
}
使用说明
快速入门步骤
第一步:完成前置条件
- 在 Google Cloud Console 中创建项目
- 启用 Indexing API
- 创建服务账户(Service Account)并获取密钥文件
- 在 Google Search Console 中验证网站所有权
- 将服务账户邮箱地址添加为 Search Console 的所有者
第二步:申请配额
- 默认提供 200 个 API 配额用于测试
- 正式使用需要申请更高配额
第三步:获取访问令牌
- 使用服务账户的密钥文件通过 OAuth 2.0 获取 Access Token
第四步:发送 API 请求
- 携带 Access Token 向 API 端点发送 POST 请求
关键信息
适用范围
- 仅限包含
JobPosting或BroadcastEvent(含VideoObject)结构化数据的页面 - 其他类型的页面应使用 Sitemap 或 Search Console 的 URL 提交功能
与 Sitemap 的关系
- 对于短期有效的页面(如职位招聘),优先使用 Indexing API 而非 Sitemap
- 仍然建议提交 Sitemap 以覆盖全站内容
- Indexing API 和 Sitemap 可以同时使用,互不冲突
注意事项
- 所有通过 API 提交的 URL 都会经过 Google 的垃圾内容检测
- 提交 URL 不保证一定会被索引,Google 会根据质量和相关性决定
- API 调用有配额限制,需合理规划使用
- 需要具备一定的技术开发能力(涉及 OAuth 2.0、REST API 调用等)
支持的编程语言
Google 官方提供了以下语言的客户端库: - Python - Java - PHP - Node.js - 以及其他通过 REST API 直接调用的方式
本文档为站内渲染。原始文件本地路径:saas/source/knowledge-people/Knowledge-World-人物-seo方法论-google-seo-indexing-api-83464d.md(仅本地保留,不入库不部署)