简介

借助 People API,您可以:

  • 读取和管理经过身份验证的用户的通讯录
  • 读取并复制经过身份验证的用户的“其他联系人”
  • 读取通过身份验证的用户及其联系人的个人资料信息
  • 读取网域个人资料和联系人

例如,假设经过身份验证的用户 Jen 的私密联系人中含有 Fabian 和 Ranjith。当您的应用调用 people.connections.list 以读取她的连接列表时,Jen 会显示一个同意屏幕,请求授予该应用访问该列表的权限。如果 Jen 同意,应用会针对 Fabian 和 Ranjith 读取包含 person resources 的列表。

如果应用需要特定人员的信息,它就可以调用 people.get 并传入资源名称,以获取该人员的 person resource

应用还可以通过以下方式管理联系人:使用 people.createContact 创建新联系人;使用 people.updateContact 更新它已从 people.connections.list 读取的现有联系人;使用 people.deleteContact 删除联系人。

Google Workspace 用户还可以使用 people.listDirectoryPeople 列出其目录网域个人资料和网域联系人,或使用 people.searchDirectoryPeople 搜索这些信息。

人员信息合并视图

People API 读取的人员信息将从各种来源合并,具体取决于以下条件:

来源 条件
公开的 Google 个人资料数据 始终。
Google Workspace 网域个人资料数据 网域管理员已针对网域范围的数据启用了外部联系人和个人资料共享功能,并且已授予 directory.readonly 范围
经过身份验证的用户的私有个人资料信息 已授予其中一个 profile 范围
经过身份验证的用户的联系人 已授予 contacts 范围

了解合并的个人数据

人物数据派生自一种主要来源类型。如果其他来源的数据通过经过验证的电子邮件地址、电话号码或个人资料网址连接,则这些来源的数据会与这些数据合并。个人的构成方式如下:

主源代码 通讯录 个人资料 Google Workspace 网域个人资料 Google Workspace 网域通讯录 用法
联系信息 1 0+ 0+ 0+ 针对大多数端点返回
配置文件 0+ 1 0 或 1 0 当此属性用于获取已登录用户的用户或获取其他用户 Google 帐号的用户时,在 people.get 中返回。
网域联系人 0+ 0 0 1 people.listDirectoryPeoplepeople.searchDirectoryPeople 中返回。

变更端点只能修改联系人。不支持个人资料和网域联系人更改。