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 . |
Только люди, основанные на контактах, могут быть изменены конечными точками мутации. Мутации контактов профиля и домена не поддерживаются.