People API

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

Сервис: people.googleapis.com

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

Документ обнаружения

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