PeopleQuickstart使用contacts.other.readonly作用域无法获取其他联系人问题

算力阿峰

2026-10-12

无法获取Google联系人中「其他联系人」的常见原因及解决办法

1. 旧授权缓存未清理

你添加新作用域后如果没有删除本地已缓存的授权凭证，新权限不会实际生效。

找到快速启动项目默认存储凭证的目录：用户根目录下的.credentials/people-quickstart文件夹
删除该文件夹下所有文件，重新运行项目重新走OAuth授权流程，确保授权弹窗里出现「查看你的其他联系人」相关权限提示，用户确认后新作用域才会生效。

2. 调用的API接口不匹配

people.connections.list 接口默认仅返回你主动添加的「我的联系人」列表，要获取「其他联系人」必须调用专门的 otherContacts.list 接口，同时必须配置正确的readMask参数，没有配置readMask会直接返回空结果。如果你需要同时获取「我的联系人」和「其他联系人」，需要分别调用两个接口，再自行合并结果集。
参考Java调用示例：

ListOtherContactsResponse response = peopleService.otherContacts()
    .list()
    .setReadMask("names,emailAddresses,phoneNumbers")
    .setPageSize(1000)
    .execute();
List<Person> otherContacts = response.getOtherContacts();