Google Indexing API 详解：让新页面更快进入 Google 抓取队列

对大多数出海站点而言，Google 搜索是自然流量的主阵地。页面发布并不等于 Google 会马上来爬——站点体量大、URL 层级深、内链不足时，新页面被发现往往要拖上数天。

Google 提供了多种程序化提交收录的方式，核心是 Indexing API 及 Search Console 相关能力。本文说明主动提交的意义、Google 侧如何配置，以及 IndexMate 如何把 Google 与必应、百度的索引流程合在一起。

为什么要在 Google 侧主动提交 URL？

策略	发现速度	运维成本
等 Googlebot 自然爬取	不确定	无
仅在 GSC 提交 Sitemap	优于纯被动	定期维护
Indexing API / URL 通知	官方最快的主动通道之一	初次配置后可自动化

主要好处：

缩短抓取等待 — 明确告诉 Google「这个 URL 是新的或已更新」，而不是只靠内链慢慢传递信号。
运营可控 — 优先推送上线页、文档页、高价值落地页。
适合自动化 — 对接 CMS、CI/CD 或 Sitemap 监控。
可度量 — 结合 Search Console 覆盖率与 IndexMate 提交日志复盘。

Google 仍可能拒绝收录低质量、重复或被 noindex / robots 拦截的页面。API 是抓取请求，不是排名保证。

Google Indexing API 概览

Google Indexing API（indexing.googleapis.com）允许已验证站点的所有者向 Google 发送 URL 变更通知。

典型配置流程

在 Google Search Console 验证站点所有权。
在 Google Cloud 创建 Google Cloud 项目 并启用 Indexing API。
创建 Service Account，下载 JSON 密钥，将该账号邮箱添加为 Search Console 的所有者。
调用 urlNotifications.publish，类型为 URL_UPDATED 或 URL_DELETED。

请求示例（概念）

POST https://indexing.googleapis.com/v3/urlNotifications:publish
Authorization: Bearer {OAuth2 access token}
Content-Type: application/json

{
  "url": "https://www.example.com/new-article",
  "type": "URL_UPDATED"
}

配额与适用范围

最初面向招聘、直播等结构化场景；许多站点在合规前提下将其用于抓取通知。
每日有配额限制 — 应优先用于真正重要的 URL。
URL 需与 Search Console 属性一致（HTTPS、首选域名、canonical 规范）。

Search Console 手动方式（不适合规模化）

在 GSC 使用 网址检查 → 请求编入索引 适合偶尔单条 URL；高频发布应使用 Indexing API 或 IndexMate 等工具。

实践建议

有意义的变更再提交 — 新页、大改版；不必为每个错别字都推一次。
先排除拦截 — noindex、robots 封禁、5xx 错误会浪费配额。
统一 canonical — 与 GSC 属性类型（网域 / 网址前缀）保持一致。
看覆盖率报告 — 关注「已编入索引」「已抓取 - 尚未编入索引」等状态。
Sitemap + API 并用 — Sitemap 负责全量发现，API 负责关键 URL 的时效性。

常见错误与排查

提交失败时，IndexMate 会在提交历史中展示 API 返回的原始错误。多数 Google 报错是权限或配置问题，不是 IndexMate 的 bug。

这条错误是什么意思？

{
  "code": 403,
  "message": "Permission denied. Failed to verify the URL ownership.",
  "status": "PERMISSION_DENIED"
}

含义： OAuth 已成功（Service Account 密钥有效），但 Google 认为当前 Service Account 对该 URL 对应的 Search Console 资源没有所有权。

常见原因不是密钥无效，而是 Search Console 权限 / 资源类型 / URL 不匹配。

你需要做的（按顺序排查）

1. 在 Search Console 添加 Service Account 为资源用户

打开 Google Search Console
选中你的站点资源（域名资源或 URL 前缀资源）
设置 → 用户和权限 → 添加用户
填入 JSON 里的 client_email（形如 xxx@xxx.iam.gserviceaccount.com）
权限选 所有者（Owner）（仅「完全」有时不够，建议 Owner）

IndexMate 配置页上传 JSON 后会显示 client_email，复制那个邮箱即可。

2. 确认资源类型与提交的 URL 一致

IndexMate 默认推导的是：

Resource ID: sc-domain:example.com

这对应 Search Console 的 网域资源（Domain property）。

你的 SC 资源	应提交的 URL 示例
网域资源 `example.com`	`https://example.com/page`、`https://www.example.com/page` 都可以
URL 前缀 `https://www.example.com/`	只能提交带 www、同 scheme 的 URL
URL 前缀 `https://example.com/`	不能提交 `https://www.example.com/...`

手动提交时，URL 必须与 SC 里已验证的资源匹配（包括 http/https、www 有无）。

3. 确认站点已在 Search Console 验证

域名资源： DNS TXT 验证
URL 前缀： HTML 文件 / DNS / GA 等

未验证完成时，Indexing API 也会返回 403。

4. 等待权限生效

添加 Service Account 后，有时需要 几分钟到几小时 才生效。可先改一条 URL 重试，不要连续狂点重试。

其他常见响应（简要）

状态码	常见原因
`401` / 凭证无效	JSON 错误、密钥过期，或 Cloud Console 未启用 Indexing API
`429`	超出每日配额 — 优先提交重要 URL
`400`	URL 格式错误或 `type` 值无效

排查时可在 IndexMate 提交日志中查看完整响应内容。