API людей позволяет:
- Чтение и управление контактами аутентифицированного пользователя
- Прочтите и скопируйте «Другие контакты» аутентифицированного пользователя.
- Чтение информации профиля для аутентифицированных пользователей и их контактов
- Чтение профилей и контактов домена
Например, предположим, что у аутентифицированного пользователя Джен есть Фабиан и Ранджит в ее личных контактах. Когда ваше приложение вызывает 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 людей, объединяется из разных источников в зависимости от следующих условий:
| Источник | Состояние |
|---|---|
| Данные общедоступного профиля 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 . |
Только люди, основанные на контактах, могут быть изменены конечными точками мутации. Мутации контактов профиля и домена не поддерживаются.