Indexing API Get Metadata请求持续返回404错误，求助排查方案

该接口是正常可用的，已有不少开发者成功实现相关功能。针对你遇到的404错误，可按以下步骤排查：

核心前提确认 #

urlNotifications/metadata接口仅返回通过Indexing API主动提交过的URL的通知元数据。如果URL是Google自动抓取索引的，或是从未通过该API提交过，哪怕页面已被索引，也会返回404。请先确保测试用的URL确实通过API提交过索引请求。

具体排查步骤 #

• 严格检查URL编码
  必须对目标URL进行完整的URL编码，包括协议（https://）、路径、查询参数等所有字符。C#中推荐使用Uri.EscapeDataString()方法，示例代码：

  string rawUrl = "https://your-site.com/page?param=value";
  string encodedUrl = Uri.EscapeDataString(rawUrl);
  string requestUrl = $"https://indexing.googleapis.com/v3/urlNotifications/metadata?url={encodedUrl}";
  

  避免使用HttpUtility.UrlEncode()，该方法会将空格编码为+，不符合接口要求的编码规范。

• 验证权限配置
  虽然提交索引功能正常，但需确认服务账号已被添加为对应网站在Google Search Console中的所有者（而非仅编辑者权限）。接口对权限的要求和提交索引一致，若服务账号权限过期或配置错误，也可能导致404。

• 核对接口端点正确性
  确认请求端点拼写完全正确：https://indexing.googleapis.com/v3/urlNotifications/metadata，注意v3版本号、urlNotifications的大小写，参数名是url，无拼写错误。

• 用工具排除代码问题
  先用Postman或curl直接调用接口测试：

  curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" "https://indexing.googleapis.com/v3/urlNotifications/metadata?url=ENCODED_URL"
  

  如果工具调用成功，说明问题出在C#代码的请求构造上；如果工具也返回404，说明是URL本身或权限的问题。

成功案例参考 #

很多开发者在自动化SEO工具中使用该接口跟踪提交后的索引状态：提交批量URL后，定期调用该接口获取每个URL的最新通知记录（如最后提交时间、提交类型等），以此确认索引请求的处理状态。

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