Google Search Console API认证范围不足问题排查：Python调用报错

问题核心 #

你遇到的403权限范围不足错误，并非因为缺少文档要求的https://www.googleapis.com/auth/webmasters权限，而是本地默认凭据的缓存问题导致实际使用的凭据未包含该权限。

解决步骤 #

1. 清除本地默认凭据缓存
   • 手动删除凭据文件：
     • Windows：删除%APPDATA%\gcloud\credentials目录下的文件
     • macOS/Linux：删除~/.config/gcloud/credentials目录下的文件
   • 或者用命令行撤销现有默认凭据：

     gcloud auth application-default revoke
     

2. 重新运行Python脚本
   执行脚本时会触发新的授权流程，此时系统会请求你授予https://www.googleapis.com/auth/webmasters权限，完成授权后即可正常调用API。

原因说明 #

API Explorer使用的是当前Google账号的实时授权，而本地google.auth.default()会优先读取已缓存的凭据。如果之前你用同一账号授权过其他Google服务（且未包含webmasters权限），缓存的凭据不会自动更新为新的scope，导致实际请求时权限不足。

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