Gmail Node.js客户端中除'me'外如何使用Gmail API的userId参数

Gmail API userId参数使用说明 #

• userId 除特殊值 me 外，可直接传入对应用户的完整Gmail邮箱地址，前提是当前使用的认证凭据具备该邮箱的操作权限。
• 无论使用 me 还是具体邮箱地址，都要求你通过 googleClient.setCredentials() 加载的OAuth2令牌归该用户所有，无对应权限的情况下无论传入什么值都会返回403权限错误。

需求实现方案 #

你不需要修改原有认证逻辑，只需要在用户完成OAuth授权阶段，额外存储该用户的Gmail邮箱地址即可，获取用户邮箱的方式有两种：

1. 授权时申请 userinfo.email 权限，直接从认证返回的用户信息中提取邮箱
2. 首次调用接口时先通过 gmail.users.getProfile({userId: 'me'}) 拿到返回结果里的 emailAddress 字段存储

修改后的代码参考如下：

const googleClient = new google.auth.OAuth2(client_id, client_secret, redirect_uri);

async function getUnreadEmailsFrom(userEmail) {
  // 加载对应用户的认证令牌，这一步逻辑和之前完全一致
  googleClient.setCredentials(userToken);
  const gmail = google.gmail({ version: 'v1', auth: googleClient });
  // 直接将userId替换为提前存储的用户真实Gmail邮箱即可
  const response = await gmail.users.messages.list({
    userId: userEmail, 
    q: 'is:unread', 
    maxResults: 500 
  });
  return response.data;
}

注意事项 #

• 传入的邮箱地址必须和当前加载的令牌所属用户的邮箱完全一致，否则请求会失败
• 官方仅支持me和对应用户的Gmail邮箱两个有效值，没有其他可传入的userId类型。如果是谷歌工作区管理员做域内用户模拟，需先开通全域权限委派，之后可直接传入域内任意用户的邮箱作为userId，不需要单独获取用户令牌。

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