Управление контактными делегатами

В этом руководстве описано, как создавать, отображать и удалять контактных лиц, назначенных пользователями Google Workspace.

Пользователи Google Workspace могут предоставлять другим пользователям в своем домене разрешения на доступ к своим контактам и управление ими. Эти пользователи могут добавлять и обновлять контакты, указывая такую ​​информацию, как имена, номера телефонов и адреса.

Это руководство предназначено для делегирования доступа контактам. Чтобы делегировать доступ к Gmail, см. раздел «Делегирование и совместная работа с электронной почтой» .

Предварительные требования

Прежде чем использовать API делегирования контактов, убедитесь, что вы соответствуете следующим требованиям:

  • Включение общего доступа к контактам : Администратор каталога должен включить общий доступ к контактам в консоли администратора. Дополнительную информацию см. в разделе «Включение или отключение общего доступа к контактам» .
  • Права администратора : Для управления делегатами для других пользователей необходимо иметь права администратора «Контакты».
  • Ограничение по домену : вы можете делегировать контакты только между пользователями в рамках одной организации Google Workspace.
  • Область действия OAuth : Ваше приложение должно использовать следующую область действия OAuth: https://www.googleapis.com/auth/admin.contact.delegation .

Создать делегата

Для создания делегата для пользователя отправьте POST запрос, указав адрес электронной почты делегатора:

POST https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates

Замените USER_EMAIL на адрес электронной почты делегатора.

В тексте запроса укажите адрес электронной почты делегата:

{
  "email": "DELEGATE_EMAIL"
}

Замените DELEGATE_EMAIL на адрес электронной почты делегата.

В случае успешного ответа возвращается код состояния HTTP 200 и адрес электронной почты нового делегата:

{
  "email": "DELEGATE_EMAIL"
}

Список делегатов

Чтобы вывести список делегатов для контактов пользователя, отправьте GET запрос, указав адрес электронной почты этого пользователя:

GET https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates

Замените USER_EMAIL на адрес электронной почты пользователя.

В случае успешного ответа возвращается код состояния HTTP 200 и список адресов электронной почты делегатов:

{
  "delegates": [
    {
      "email": "DELEGATE_EMAIL_1"
    },
    {
      "email": "DELEGATE_EMAIL_2"
    }
  ]
}

Удалить делегата

Чтобы удалить делегата для контактов пользователя, выполните следующие действия:

  1. Определите делегата, которого нужно удалить. Используйте метод «Список делегатов» , чтобы найти адрес электронной почты конкретного делегата.

  2. Отправьте запрос DELETE , указав адреса электронной почты делегатора и делегата:

    DELETE https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates/DELEGATE_EMAIL

Замените USER_EMAIL на адрес электронной почты делегатора, а DELEGATE_EMAIL на адрес электронной почты делегата.

В случае успешного ответа возвращается код состояния HTTP 200 .