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"
}

使用说明

快速入门步骤

第一步：完成前置条件

1. 在 Google Cloud Console 中创建项目
2. 启用 Indexing API
3. 创建服务账户（Service Account）并获取密钥文件
4. 在 Google Search Console 中验证网站所有权
5. 将服务账户邮箱地址添加为 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/seo-llm/raw-seo知识库-seo方法论-google-seo-indexing-api-392261.md（仅本地保留，不入库不部署）