使用Google Indexing API提交URL后查询元数据返回404错误求助

问题场景 #

• 调用发布接口提交URL：

  POST https://indexing.googleapis.com/v3/urlNotifications:publish
  

  请求体：

  {
      "url": "https://kunfirm.me/jobs/Abia/Aba/66de5c3d8559681b41aadaf5/view",
      "type": "URL_UPDATED"
  }
  

  成功响应：

  {
    urlNotificationMetadata: {
      url: 'https://kunfirm.me/jobs/Abia/Aba/66de5c3d8559681b41aadaf5/view'
    }
  }
  

• 使用同一访问令牌调用查询接口：

  GET https://indexing.googleapis.com/v3/urlNotifications/metadata?url=https%3A%2F%2Fkunfirm.me%2Fjobs%2FAbia%2FAba%2F66de5c3d8559681b41aadaf5%2Fview
  

  返回404错误：

  {
      "error": {
          "code": 404,
          "message": "Requested entity was not found.",
          "status": "NOT_FOUND"
      }
  }
  

• 前置条件：URL可正常访问，已通过Google Search Console验证，生成令牌时添加了https://www.googleapis.com/auth/webmasters.readonly权限，用户拥有站点所有者权限，多个URL均出现相同问题。

排查与解决方向 #

1. 修正访问令牌的权限范围 #

查询URL元数据需要**https://www.googleapis.com/auth/indexing**权限，而非仅webmasters.readonly。publish接口和查询接口都依赖这个权限，重新生成包含该权限的访问令牌再尝试。

2. 严格匹配URL编码与原始URL #

确保查询时的URL编码完全对应提交的原始URL：

• 检查是否存在大小写差异、末尾斜杠、额外参数等不一致情况；
• 可以直接将原始URL通过标准URL编码工具处理后，替换到查询接口的参数中，避免手动编码出错。

3. 等待系统同步延迟 #

publish接口返回成功仅代表请求被接收，Google内部系统需要时间同步元数据状态。建议等待15-30分钟后重试，首次提交的新URL同步时间可能更长。

4. 确认Search Console站点归属一致性 #

确保生成令牌的Google账号，在Search Console中验证的站点域名与提交URL的域名完全匹配：

• 比如验证的是https://kunfirm.me（无www），提交的URL也必须是同协议同前缀的，Google对站点归属的区分是严格的。

5. 检查页面本身的索引兼容性 #

用Google Search Console的「URL检查工具」测试目标URL，确认：

• 页面没有noindex标签或响应头；
• robots.txt未禁止爬虫访问该路径；
• 页面内容符合Google索引标准（非重复、低质量内容）。

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