如何为Gmail Python API授予个人使用权限并解决验证错误

一、确认项目配置符合个人使用要求 #

• 确保你的Google Cloud项目由个人账号创建，而非组织/企业账号——组织账号即使个人使用也可能触发验证要求。
• 检查OAuth同意屏幕配置：
  1. 登录Google Cloud控制台，进入「API和服务」→「OAuth同意屏幕」
  2. 确认用户类型选「外部」，且测试用户列表中添加了你要授权的Gmail账号（没加的话直接补充）
  3. 保存配置后重新运行授权流程

二、强制跳过验证授权的操作 #

如果配置没问题但仍看不到未验证应用界面，可通过修改URL强制跳转：

1. 出现验证错误页面时，在浏览器地址栏找到当前URL，把&prompt=consent参数替换为&prompt=select_account，或直接在URL末尾添加&allow_non_trusted=true
2. 刷新页面后会出现「高级」选项，点击后选择「继续访问[你的应用名称]」即可绕过验证完成授权

三、改用服务账号（无验证需求） #

如果以上方法失效，可切换为服务账号实现只读访问，完全不需要OAuth验证：

• 在Google Cloud控制台创建服务账号，下载JSON密钥文件
• 进入Gmail账号的账号管理后台，将服务账号委派为你的Gmail账号只读权限
• 代码中用服务账号密钥认证，示例片段：

from google.oauth2 import service_account
from googleapiclient.discovery import build

SCOPES = ['https://www.googleapis.com/auth/gmail.readonly']
SERVICE_ACCOUNT_FILE = 'path/to/your/service-account-key.json'

credentials = service_account.Credentials.from_service_account_file(
    SERVICE_ACCOUNT_FILE, scopes=SCOPES, subject='your-personal-gmail@gmail.com')

service = build('gmail', 'v1', credentials=credentials)

四、重置OAuth应用配置 #

• 删除当前的OAuth客户端ID，重新创建一个新的「桌面应用」类型客户端ID
• 下载新的credentials.json替换原文件，再重新运行授权流程

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