简介

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

通过 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.listDirectoryPeoplepeople.searchDirectoryPeople 中返回。

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