Google Gmail API OAuth授权同意流程中部分权限范围缺失
解决Gmail API测试应用OAuth同意屏幕不显示修改类权限的问题
确认权限范围配置
- 打开Google Cloud控制台的API和服务 > 凭据页面,检查对应OAuth客户端ID的「已授权的重定向URI」是否存在拼写错误,配置错误会导致权限加载异常。
- 进入API和服务 > OAuth同意屏幕,在「范围」板块点击「添加或删除范围」,手动搜索并添加
https://www.googleapis.com/auth/gmail.labels和https://www.googleapis.com/auth/gmail.modify权限,选中后保存配置。
清除旧授权令牌并重新授权
- 若为代码实现的应用,找到存储OAuth令牌的文件(通常是
token.json)并删除;若为浏览器端应用,清除对应域名的Cookie和本地存储数据。 - 重启应用并重新发起OAuth授权流程,此时同意屏幕应显示已添加的修改类权限。
检查测试用户列表
- 在OAuth同意屏幕的「测试用户」部分,确认用于授权的Google账号已被添加至列表中。测试状态下,仅列表内的账号能看到完整权限范围,未添加的账号会被限制为只读权限。
验证Gmail API启用状态
- 进入API和服务 > 库页面,确认Gmail API处于启用状态,避免因API被禁用导致权限无法正常加载。
内容的提问来源于stack exchange,提问作者Alana Storm
相关产品推荐
相关产品推荐

