Введение

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 .

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