indexing api.md

# 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：**

```json
{
  "url": "https://example.com/jobs/123",
  "type": "URL_UPDATED"
}
```

**删除 URL：**

```json
{
  "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知识库-TXT整理-seo方法论-google-seo-indexing-api-md-a61ba6.txt（仅本地保留，不入库不部署）