如何配置Google OAuth使授权窗口支持用户勾选权限自主选择？

要实现让员工自主选择是否授予gmail.readonly权限，核心在于调整Google Cloud Console的OAuth权限配置，同时配合代码中的Scope设置，具体步骤如下：

1. 调整Google Cloud Console的OAuth同意屏幕配置 #

这是显示复选框的关键操作：

• 登录Google Cloud Console，进入你的项目
• 导航到APIs & Services > OAuth consent screen
• 在Scopes for Google APIs部分，将https://www.googleapis.com/auth/gmail.readonly添加到Optional Scopes（可选权限）列表，而非Required Scopes（必填权限）
• 保存配置并发布

2. 修改代码中的Scope配置 #

确保同时请求基础身份权限和可选的gmail权限，让授权窗口能区分必填/可选权限，从而显示复选框：

const login = useGoogleLogin({
  onSuccess: (codeResponse) => {
    getApiAccessToken(codeResponse);
  },
  // 组合基础身份权限与可选的gmail只读权限
  scope: 'openid email profile https://www.googleapis.com/auth/gmail.readonly',
  flow: 'auth-code',
  enable_serial_consent: false,
  include_granted_scopes: false,
  onError: () => {
    handleError();
  },
});

关键说明 #

• 若仅请求单一的gmail.readonly权限，即使设为可选，Google授权窗口也不会显示复选框——必须搭配基础身份权限（openid/email/profile），让系统区分出"必填身份验证"和"可选邮箱访问"两类权限，才会触发复选框显示。
• 测试前需让用户撤销该应用的现有授权（Google账户→安全→第三方应用访问→找到你的应用并撤销），避免因已授权过而跳过权限选择步骤。

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