调用Google Search Console API时遇403 Forbidden错误求助

针对你调用Google Search Console API时遇到的403 Forbidden错误，即使已启用API并配置服务账号密钥，以下是关键排查和修复方向：

1. 确认服务账号已添加到站点权限 #

这是最常见的触发原因：

• 登录Google Search Console，打开目标站点
• 进入「设置」→「用户和权限」
• 点击「添加用户」，填入服务账号的client_email（即.env.local里的SEARCH_CONSOLE_CLIENT_EMAIL）
• 至少授予「查看者」权限（匹配你代码中使用的readonly权限范围），保存后等待几分钟再测试

2. 检查siteUrl格式与站点属性类型匹配 #

Search Console有两种站点属性类型，siteUrl格式必须严格对应：

• 若为域名属性（通过DNS验证的domain.com），代码中需使用sc-domain:domain.com格式（你的代码当前采用此格式，需确认站点属性类型一致）
• 若为URL前缀属性（如https://domain.com/），siteUrl必须填写完整URL，不能使用sc-domain:前缀

3. 验证环境变量中的私钥格式 #

确保.env.local里的SEARCH_CONSOLE_PRIVATE_KEY格式正确：

• 私钥必须包含完整的-----BEGIN PRIVATE KEY-----和-----END PRIVATE KEY-----头部/尾部
• 中间换行需转义为\\n，示例：

  SEARCH_CONSOLE_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\nMIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC...\n-----END PRIVATE KEY-----"
  

• 避免私钥前后存在多余空格或引号

4. 确认API权限范围配置正确 #

你代码中使用的https://www.googleapis.com/auth/webmasters.readonly是正确的只读权限范围，需额外确认：

• Google Cloud控制台的IAM中，服务账号未被限制该权限范围
• 代码中未误写权限范围字符串

代码细节修正 #

• 注意到catch块中有命名不一致：type === 'stats'但调用时传的是'stat'，虽不触发403，但建议修正以统一命名，避免日志显示错误
• 确保domainName参数传递正确，若使用sc-domain:格式，不要传入https://前缀，仅传纯域名（如domain.com）

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