通过 People API，您可以：
例如，假设经过身份验证的用户 Jen 的私密联系人中含有 Fabian 和 Ranjith。当您的应用调用 people.connections.list 来读取她的连接列表时，Jen 会看到一个同意屏幕，请求授予该应用对该列表的访问权限。如果 Jen 同意，该应用会读取一个包含 person resources 的列表，供 Fabian 和 Ranjith 使用。
如果应用需要特定人员的信息，则可以调用 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.listDirectoryPeople 或 people.searchDirectoryPeople 中返回。 |
修改端点只能修改基于联系人的人员。不支持个人资料和网域联系人变更。