Введение

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 .

Только люди, основанные на контактах, могут быть изменены конечными точками мутации. Мутации контактов профиля и домена не поддерживаются.