使用服务账号模拟用户读取联系人失败（HTTP 404错误）求助

看起来你在通过服务账号模拟普通用户读取联系人时遇到了404问题，我来帮你排查几个关键的可能原因和解决办法：

1. 确认权限范围是否匹配需求 #

你之前启用了Admin和People API，但读取普通用户联系人需要的是People API的特定权限，而不是Admin API的目录权限。请检查Google Admin控制台的「域范围委派」设置，确保为服务账号添加了以下权限之一：

• https://www.googleapis.com/auth/contacts（读写权限）
• https://www.googleapis.com/auth/contacts.readonly（只读权限）

如果只添加了Admin API相关的权限，服务账号就没有权限访问普通用户的私人联系人，这很可能是404错误的根源。

2. 验证模拟的用户身份正确性 #

确保你模拟的是域内有效的普通用户邮箱（比如user@yourdomain.com），而不是管理员账号、不存在的邮箱，或者格式错误的地址。另外，建议先确认该用户的Google Contacts中确实存在联系人数据——如果用户从未创建过联系人，虽然一般会返回空列表而非404，但也可以排除这个极端情况。

3. 修正API调用的端点与参数 #

读取用户联系人需要使用People API的people.connections.list接口，而不是Admin API的目录接口。注意参数里的resourceName要设为people/me（因为模拟了目标用户，me就代表该用户），同时指定需要获取的联系人字段。

这里给你一个修正后的代码示例：

var google = require('googleapis').google;
var googleKey = require('./key/google-services.json');

// 初始化JWT客户端，确保权限范围和模拟用户正确
const jwtClient = new google.auth.JWT(
  googleKey.client_email,
  null,
  googleKey.private_key,
  ['https://www.googleapis.com/auth/contacts.readonly'], // 使用正确的权限范围
  'target-user@your-domain.com' // 替换为要模拟的普通用户邮箱
);

// 授权并调用People API获取联系人
jwtClient.authorize(async (err, tokens) => {
  if (err) {
    console.error('授权失败:', err);
    return;
  }

  const peopleApi = google.people({ version: 'v1', auth: jwtClient });
  
  try {
    const response = await peopleApi.connections.list({
      resourceName: 'people/me', // 代表当前模拟的用户
      pageSize: 20,
      personFields: 'names,emailAddresses,phoneNumbers' // 指定需要返回的字段
    });

    const contacts = response.data.connections || [];
    console.log(`找到 ${contacts.length} 个联系人:`);
    contacts.forEach(contact => {
      console.log(`姓名: ${contact.names?.[0]?.displayName}, 邮箱: ${contact.emailAddresses?.[0]?.value}`);
    });
  } catch (apiError) {
    console.error('API调用出错:', apiError.response?.data || apiError.message);
  }
});

4. 确认域范围委派设置生效 #

虽然你提到已经开启了域范围委派，但有时候添加权限后需要等待5-10分钟才会生效。如果刚修改完设置，可以稍等片刻再测试。另外，检查服务账号的客户端ID是否正确添加到了域范围委派的列表中。

5. 排查用户联系人的存储位置 #

有些用户可能将联系人存储在第三方服务（如Outlook）而非Google Contacts中，这种情况下调用People API是无法读取到数据的。可以让目标用户登录Google Contacts网页版，确认联系人确实存在于该平台。

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