Node.js后端调用Google People API获取生日性别失败排查

我一眼就发现了核心问题：你调用Google People API时用API Key做认证，但要获取用户授权过的隐私数据（生日、性别），必须使用客户端传来的OAuth2 access token进行认证，API Key根本不具备访问这类用户授权数据的权限。

为什么API Key不行？ #

Google的API Key仅用于访问公开的、无需用户授权的数据接口，而你要获取的生日、性别属于需要用户明确授权的隐私数据（哪怕你设置为公开），必须通过OAuth2的用户授权流程获取的access token来验证身份，证明用户已经允许你的应用访问这些数据。

修正后的代码 #

把认证方式换成基于OAuth2的客户端，直接使用客户端传来的access token：

const {google} = require('googleapis');
async function getDataFromPeopleAPI(googleId, accessToken) {
  try {
    // 初始化OAuth2客户端并设置用户的access token
    const oauth2Client = new google.auth.OAuth2();
    oauth2Client.setCredentials({ access_token: accessToken });

    // 用OAuth2客户端初始化People API服务
    const peopleService = google.people({ version: 'v1', auth: oauth2Client });

    const params = {
      resourceName: `people/${googleId}`,
      personFields: 'birthdays,genders'
      // 注意：这里不需要再单独传access_token参数，auth已经处理了
    };

    const res = await peopleService.people.get(params);
    const {birthdays, genders} = res.data;
    
    // 现在应该能拿到你需要的数据了
    console.log('用户生日:', birthdays);
    console.log('用户性别:', genders);
  } catch (e) {
    console.error('调用People API失败:', e.response?.data || e.message);
  }
};

额外注意事项 #

• 确认客户端请求的权限范围确实包含https://www.googleapis.com/auth/user.birthday.read和https://www.googleapis.com/auth/userinfo.profile，可以通过访问https://oauth2.googleapis.com/tokeninfo?access_token=YOUR_TOKEN验证access token的有效范围。
• 确保access token未过期，OAuth2 access token通常有效期为1小时，如果过期需要客户端刷新token。
• 检查personFields参数的拼写是否正确，你当前的写法是没问题的，确保只请求你需要的字段（这也是Google API的要求）。

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