Google Search Console API报错：陌生项目编号未启用API的排查与解决

一、定位报错中的项目编号所属项目 #

• 查OAuth客户端ID关联的项目：报错里的项目号基本就是你用来做OAuth认证的客户端ID所属的GCP项目。打开Google Cloud Console，进「API和服务」→「凭据」页面，找你当前用的OAuth客户端ID，它对应的项目就是报错里的那个。要是找不到，可能这个客户端ID属于你其他谷歌账号下的项目，或是组织里共享的项目。
• 看GSC属性关联的项目：登录Google Search Console，进目标属性的「设置」→「关联的Google Cloud项目」，看看有没有这个项目编号。有些时候GSC属性会默认关联一个系统创建的隐藏项目。
• 解码访问令牌确认：把你的OAuth访问令牌复制到JWT解码工具解码，查看aud字段对应的OAuth客户端ID，再回到GCP凭据页面搜这个客户端ID，就能找到所属项目。
• 用Cloud资源管理器搜索：通过Google Cloud资源管理器直接输入项目编号搜索，哪怕你没这个项目的权限，也能看到项目名称、所属组织这些基本信息，确认是不是你之前用过的项目。

二、把API访问指向你的目标GCP项目 #

• 在目标项目创建新OAuth客户端ID：在你已经启用Search Console API的GCP项目里，进「API和服务」→「凭据」，创建新的OAuth客户端ID（根据你的应用类型选，比如桌面应用、Web应用）。
• 重新获取访问令牌：用新创建的OAuth客户端ID，重新走OAuth2认证流程，拿到包含https://www.googleapis.com/auth/webmasters.readonly作用域的访问令牌，确保这个令牌关联的是你的目标GCP项目。
• 验证权限配置：确认你的主体（用户或服务账号）同时具备：
  • Google Search Console目标属性的「所有者」或「编辑」权限；
  • 目标GCP项目中Search Console API的访问权限（可以通过IAM页面添加「Search Console 只读」角色）。
• 再确认API启用状态：在目标GCP项目的「API和服务」→「库」里，搜「Google Search Console API」，确保它的状态是「已启用」。

Google Search Console API 尚未在项目256595xxxxxx中使用过或已被禁用

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