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

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

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

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

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

POST https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates

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

{
  "email": "delegate@example.com"
}

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

{
  "email": "delegate@example.com"
}

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

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

GET https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates

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

{
  "delegates": [
    {
      "email": "delegate1@example.com"
    },
    {
      "email": "delegate2@example.com"
    }
  ]
}

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

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

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

    DELETE https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates/delegate@example.com
    

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