message: send

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Отправка существующего черновика сообщения.

Черновик сообщения может быть предназначен для нового сообщения, ответа, ответа всем пользователям или пересылки.

Этот метод сохраняет сообщение в папке Отправленные.

Другой способ — отправка нового сообщения за один шаг.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальное обслуживание Правительство США L4 Правительство США L5 (DOD) Китай, обслуживаемый 21Vianet

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более высокий уровень привилегий или разрешений, только если это требуется вашему приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в статье Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшим объемом привилегий Разрешения с более высоким уровнем привилегий
Делегированные (рабочая или учебная учетная запись) Mail.Send Недоступно.
Делегированные (личная учетная запись Майкрософт) Mail.Send Недоступно.
Для приложений Mail.Send Недоступно.

HTTP-запрос

POST /me/messages/{id}/send
POST /users/{id | userPrincipalName}/messages/{id}/send

Заголовки запросов

Имя Тип Описание
Authorization string Bearer {token}. Обязательно. Дополнительные сведения об аутентификации и авторизации.
Content-Length число 0. Обязательный.

Текст запроса

Так как этот метод отправляет уже существующий черновик сообщения, указывать тело запроса необязательно.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 202 Accepted. В тексте ответа ничего не возвращается.

Примеры

Пример 1. Отправка существующего черновика сообщения

Ниже приведен пример вызова этого API.

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/beta/me/messages/{id}/send
Отклик

Ниже приводится пример отклика.

HTTP/1.1 202 Accepted