Изменить права доступа

Внимание

Эта страница устарела. Методы, описанные в этом разделе, перестанут поддерживаться с 1 ноября 2024 года. Для того, чтобы продолжать работать с делегированными ящиками, необходимо перейти на обновленные методы, описанные в разделе Общие и делегированные ящики.

Предоставляет или изменяет права доступа сотрудника к чужому почтовому ящику.

Действие асинхронное: можно отправлять следующий запрос, не дожидаясь выполнения предыдущего. Возвращает идентификатор задачи, по которому можно проверить состояние ее выполнения.

Примечание

Чтобы выполнить запрос, приложению требуется разрешение на управление правами доступа к почтовым ящикам. Убедитесь, что вы включили его при настройке приложения на OAuth-сервере Яндекса.

Request

POST

https://api360.yandex.net/admin/v1/org/{orgId}/mail/delegated

Path parameters

Name

Description

orgId*

Type: integer<int64>

Идентификатор организации.

Query parameters

Name

Description

actorId*

Type: string<uint64>

Идентификатор сотрудника, для которого настраивается доступ.

resourceId*

Type: string<uint64>

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

sendMessages

Type: boolean

Признак того, что владельцу почтового ящика и сотруднику, для которого настраивается доступ к нему, необходимо отправить письма-уведомления об изменении прав доступа.

Body

application/json
{
    "rights": [
        "string"
    ]
}

Name

Description

rights*

Type: string[]

Список прав доступа. Возможные значения:

  • imap_full_access — право на чтение почты и управление настройками ящика по протоколу IMAP, возможности отправлять письма это право не дает.
  • send_on_behalf — возможность отправлять письма из ящика по протоколу SMTP от своего имени: в поле "От кого" в письме будет указан адрес настоящего отправителя.
  • send_as — возможность отправлять письма по протоколу SMTP от имени владельца ящика: в поле "От кого" в письме будет указан адрес владелеца. Наличие у пользователя права send_as автоматически означает и включение у него права send_on_behalf, даже если оно не указано явно.

Responses

200 OK

Запрос успешно выполнен.

Body

application/json
{
    "taskId": "string"
}

Name

Description

taskId*

Type: string

Идентификатор задачи на управление правами доступа.

401 Unauthorized

Пользователь не авторизован.

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.

403 Forbidden

У пользователя или приложения нет прав на доступ к ресурсу, запрос отклонен.

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.

404 Not Found

Запрашиваемый ресурс не найден.

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.

500 Internal Server Error

Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.
Предыдущая
Удалить права доступа
Следующая
Проверить статус задачи