People API

提供对个人资料和联系人相关信息的访问权限。

服务: people.googleapis.com

要调用此服务,我们建议您使用 Google 提供的客户端库。如果您的应用程序需要使用自己的库来调用此服务,请在发出 API 请求时使用以下信息。

发现文档

发现文档是用于说明和使用 REST API 的机器可读规范。它用于构建客户端库、IDE 插件以及与 Google API 交互的其他工具。一项服务可能会提供多个发现文档。此服务提供了以下发现文档:

服务端点

服务端点是指定 API 服务的网络地址的基本网址。一项服务可能有多个服务端点。此服务具有以下服务端点,下面的所有 URI 都与此服务端点相关:

  • https://people.googleapis.com

REST 资源:v1.contactGroups

方法
batchGet GET /v1/contactGroups:batchGet
通过指定联系人群组资源名称列表,获取经过身份验证的用户拥有的联系人群组列表。
create POST /v1/contactGroups
创建由经过身份验证的用户拥有的新联系人群组。
delete DELETE /v1/{resourceName=contactGroups/*}
通过指定联系人群组资源名称,删除经过身份验证的用户拥有的现有联系人群组。
get GET /v1/{resourceName=contactGroups/*}
通过指定联系人群组资源名称,获取由经过身份验证的用户拥有的特定联系人群组。
list GET /v1/contactGroups
列出经过身份验证的用户拥有的所有联系人群组。
update PUT /v1/{contactGroup.resourceName=contactGroups/*}
更新经过身份验证的用户拥有的现有联系人群组的名称。

REST 资源:v1.contactGroups.members

方法
modify POST /v1/{resourceName=contactGroups/*}/members:modify
修改经过身份验证的用户所拥有的联系人群组中的成员。

REST 资源:v1.otherContacts

方法
copyOtherContactToMyContactsGroup POST /v1/{resourceName=otherContacts/*}:copyOtherContactToMyContactsGroup

将“其他联系人”复制到用户的“myContacts”群组中的新联系人

应依序发送同一用户的 mutate 请求,以避免延迟时间增加和失败。

list GET /v1/otherContacts
列出所有“其他联系人”,即不在联系人群组中的联系人。
search GET /v1/otherContacts:search
提供经过身份验证的用户的其他联系人中与搜索查询匹配的联系人列表。

REST 资源:v1.people

方法
batchCreateContacts POST /v1/people:batchCreateContacts

创建一批新联系人,并为新联系人返回 PersonResponses

应依序发送同一用户的 mutate 请求,以避免延迟时间增加和失败。

batchDeleteContacts POST /v1/people:batchDeleteContacts
删除一批联系人。
batchUpdateContacts POST /v1/people:batchUpdateContacts
更新一批联系人,并为更新后的联系人返回资源名称映射至 PersonResponses。
createContact POST /v1/people:createContact
创建新联系人并返回该联系人的人员资源。
deleteContact DELETE /v1/{resourceName=people/*}:deleteContact
删除联系人。
deleteContactPhoto DELETE /v1/{resourceName=people/*}:deleteContactPhoto
删除联系人的照片。
get GET /v1/{resourceName=people/*}
通过指定资源名称来提供人员的相关信息。
getBatchGet GET /v1/people:batchGet
通过指定请求的资源名称列表,提供有关特定人员列表的信息。
listDirectoryPeople GET /v1/people:listDirectoryPeople
提供经过身份验证的用户的网域目录中的网域个人资料和网域联系人列表。
searchContacts GET /v1/people:searchContacts
提供经过身份验证的用户的分组联系人中与搜索查询匹配的联系人列表。
searchDirectoryPeople GET /v1/people:searchDirectoryPeople
提供已通过身份验证的用户的网域目录中与搜索查询匹配的网域个人资料和网域联系人列表。
updateContact PATCH /v1/{person.resourceName=people/*}:updateContact
更新现有联系人的联系人数据。
updateContactPhoto PATCH /v1/{resourceName=people/*}:updateContactPhoto
更新联系人的照片。

REST 资源:v1.people.connections

方法
list GET /v1/{resourceName=people/*}/connections
提供经过身份验证的用户的联系人列表。