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