如何通过Google OAuth API获取用户Gmail电子邮箱地址
Google OAuth 2.0 调用userinfo接口无法获取Gmail地址的解决方法
核心触发原因
接口返回结果中缺失邮箱字段,和现有请求代码的核心逻辑没有直接关联,问题基本出在授权环节的权限配置上,按照以下步骤逐一排查即可解决:
排查与修正步骤
1. 核对OAuth授权的作用域配置
- 这是最高发的问题场景:调用
https://www.googleapis.com/oauth2/v3/userinfo接口时,只有授权请求中明确包含openid email作用域,返回结果才会附带用户邮箱字段;仅申请基础用户信息(profile)作用域的情况下,接口只会返回姓氏、名字、头像、性别这类公开信息,不会返回邮箱 - 在OAuth Playground开展测试时,不要依赖工具默认勾选的基础权限项,要在作用域选择环节手动添加带邮箱权限的授权项,重新生成授权链接走完完整的用户授权流程,不要复用之前没有携带email作用域生成的旧access_token
- 可以对当前持有的access_token做Payload部分解码(无需验签),直接查看token内置的权限范围列表,如果列表中没有
email项,即可确认是授权scope配置缺失导致的问题
2. 修正现有C#代码的细节问题
编写的请求逻辑存在几处格式错误,会干扰请求的正常校验,需要逐一调整:
- 代码第一行的
userinfoRequestURI字符串漏写了闭合双引号,直接运行会触发语法报错 - 移除GET请求下的无效配置:GET请求无请求体,不需要设置
ContentType为表单格式;同时修正Accept请求头的写法错误,当前代码里在Accept头的值前多写了Accept=前缀,正确的头值应该是纯媒体类型列表text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
3. 规避缓存导致的权限不更新问题
- 修改授权scope之后,不要直接复用之前的授权会话:Google的授权流程在用户已经确认过同意的场景下,会默认跳过重定向到授权成功的回调地址,不会重新弹出权限确认页,也就不会把新的scope权限追加到授权记录里
- 测试时需要主动清除OAuth Playground的本地授权缓存、登出当前登录的Google账号会话,再重新发起授权请求,确保新的权限配置真正生效
注意事项
个人Google账号测试场景下,不需要额外走企业应用的权限审核、管理员配置流程,只要授权scope正确,接口就会正常返回email和email_verified字段,不需要做额外的白名单配置
内容的提问来源于stack exchange,提问作者Noufal
相关产品推荐
相关产品推荐

