如何在原生PHP中正确使用Google Indexing API？含批量提交等问题

1. 批量提交URL的格式问题 #

你给出的两种格式都不正确：

• 格式一：JSON中url字段仅支持单个字符串值，直接放入多个URL会导致JSON格式无效。
• 格式二：JSON不允许重复键名，后出现的url和type会覆盖前面的条目，最终仅会提交最后一个URL。

正确的批量提交格式是使用requests数组，每个元素为包含url和type的独立对象，PHP代码示例：

$content = json_encode([
    'requests' => [
        ['url' => 'https://mydomain.com/', 'type' => 'URL_UPDATED'],
        ['url' => 'https://mydomain.com/page-1', 'type' => 'URL_UPDATED'],
        ['url' => 'https://mydomain.com/page-2', 'type' => 'URL_UPDATED']
    ]
]);

2. 动态嵌入当前页面URL的正确方式 #

动态获取当前页面URL是可行的，但直接拼接PHP变量到JSON字符串会因语法或转义问题失效，正确步骤：

1. 安全获取并格式化当前URL，避免非法字符：

$protocol = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') ? 'https://' : 'http://';
$rawUrl = $protocol . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
// 过滤并验证URL格式
$url = filter_var($rawUrl, FILTER_SANITIZE_URL);

2. 用PHP数组构造数据，再通过json_encode()生成标准JSON：

$content = json_encode([
    'url' => $url,
    'type' => 'URL_UPDATED'
]);

这种方式会自动处理转义问题，确保JSON格式完全合规。

3. 页面刷新重复提交的影响 #

会产生明确的不良影响：

• 浪费API配额：Google Indexing API对每个项目有每日请求限额，重复提交会快速消耗配额，导致真正需要提交的URL无法处理。
• 请求被忽略：Google会识别重复提交请求，大概率直接忽略，不会重复触发索引操作。
• 触发限流：短时间内大量重复请求可能触发Google的限流机制，导致后续正常请求被拒绝。

建议添加提交控制：比如用数据库记录每个URL的最后提交时间，仅当页面内容更新或距离上次提交超过7天（可根据需求调整）时，才执行提交操作。

4. 提交全站URL的正确方法 #

1. 生成全站URL列表：

   • 从网站数据库中直接读取所有页面的URL（适用于动态网站）。
   • 解析网站的XML sitemap文件，提取所有收录的URL。
   • 编写轻量爬虫脚本遍历网站，收集所有可访问的URL（需遵守robots.txt规则）。

2. 分批批量提交：
   建议每批次提交50-100个URL（避免单请求体积过大），使用前文提到的requests数组格式构造请求体，循环处理所有URL批次。

3. 记录提交状态：
   保存每个URL的提交结果（成功/失败），对失败的URL可重试3-5次，避免因网络波动导致的提交失败。

4. 避免重复提交：
   维护已提交URL的记录表，记录提交时间和状态，仅提交新增或内容更新过的URL。

内容的提问来源于stack exchange，提问作者Bearded