API People позволяет вам:
- Чтение и управление контактами аутентифицированного пользователя.
- Прочтите и скопируйте «Другие контакты» аутентифицированного пользователя.
- Чтение информации профиля для аутентифицированных пользователей и их контактов
- Чтение профилей домена и контактов
Например, предположим, что у проверенного пользователя Джен есть Фабиан и Ранджит в ее личных контактах. Когда ваше приложение вызывает people.connections.list , чтобы прочитать список своих контактов, Джен отображается экран согласия с просьбой предоставить приложению доступ к этому списку. Если Джен соглашается, приложение считывает список, содержащий person resources Фабиана и Ранджита.
Если приложению нужна информация о конкретном человеке, оно может затем вызвать people.get , передав имя ресурса, чтобы получить person resource для этого человека.
Приложение также может управлять контактами, создавая новые контакты с помощью people.createContact , обновляя существующие контакты, прочитанные из people.connections.list , с помощью people.updateContact и удаляя контакты с помощью people.deleteContact .
Пользователи Google Workspace также могут перечислять профили домена своего каталога и контакты домена с помощью people.listDirectoryPeople или выполнять поиск по ним с помощью people.searchDirectoryPeople .
Объединенное представление информации о людях
Информация о людях, которую считывает API People, объединяется из различных источников в зависимости от следующих условий:
| Источник | Состояние |
|---|---|
| Данные общедоступного профиля Google | Всегда. |
| Данные профиля домена Google Workspace | Администратор домена включил внешний доступ к контактам и профилям данных на уровне домена, а также была предоставлена область directory.readonly . |
| Информация личного профиля аутентифицированного пользователя | Одна из областей profile предоставлена. |
| Контакты аутентифицированного пользователя | Область contacts предоставлена. |
Понимание объединенных данных о людях
Данные о человеке извлекаются из одного основного типа источника. Данные из других источников объединяются с этими данными, если источники связаны через проверенные адреса электронной почты, номера телефонов или URL-адреса профилей. Вот как может состоять человек:
| Главный источник | Контакты | Профили | Профили доменов Google Workspace | Контакты домена Google Workspace | Применение |
|---|---|---|---|---|---|
| Контакт | 1 | 0+ | 0+ | 0+ | Возвращается для большинства конечных точек |
| Профиль | 0+ | 1 | 0 или 1 | 0 | Возвращается в people.get , когда он используется для получения данных о человеке для вошедшего в систему пользователя или для получения данных о человеке для аккаунта Google другого пользователя . |
| Контакт с доменом | 0+ | 0 | 0 | 1 | Возвращается в people.listDirectoryPeople или people.searchDirectoryPeople . |
Только люди, основанные на контактах, могут быть изменены с помощью конечных точек мутации. Мутации контактов профиля и домена не поддерживаются.