People API

Предоставляет доступ к информации о профилях и контактах.

Сервис: люди.googleapis.com.

Для вызова этой службы мы рекомендуем использовать клиентские библиотеки Google. Если вашему приложению необходимо использовать собственные библиотеки для вызова этой службы, используйте следующую информацию при отправке запросов API.

Документ открытия

Документ обнаружения — это машиночитаемая спецификация для описания и использования REST API. Он используется для создания клиентских библиотек, плагинов IDE и других инструментов, взаимодействующих с API Google. Одна служба может предоставлять несколько документов обнаружения. Эта служба предоставляет следующий документ обнаружения:

Конечная точка службы

Конечная точка службы — это базовый URL-адрес, указывающий сетевой адрес службы 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

Копирует «Другой контакт» в новый контакт в группе «Мои контакты» пользователя.

Запросы на изменение для одного и того же пользователя следует отправлять последовательно, чтобы избежать увеличения задержек и сбоев.

list GET /v1/otherContacts
Перечислите все «Другие контакты», то есть контакты, которых нет в группе контактов.
search GET /v1/otherContacts:search
Предоставляет список контактов среди других контактов прошедшего проверку подлинности пользователя, соответствующих поисковому запросу.

Ресурс REST: v1.people

Методы
batchCreateContacts POST /v1/people:batchCreateContacts

Создайте пакет новых контактов и верните PersonResponses для новых контактов.

Запросы на изменение для одного и того же пользователя следует отправлять последовательно, чтобы избежать увеличения задержек и сбоев.

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
Предоставляет список контактов аутентифицированного пользователя.