message: send

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

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

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

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

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

Разрешения

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

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

HTTP-запрос

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

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

Имя	Тип	Описание
Authorization	string	Носитель {token}. Обязательно.
Content-Length	число	0. Обязательный.

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

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

Отклик

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

Примеры

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

В приведенном ниже примере показано, как вызывать этот API.

Запрос

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

HTTP

POST https://graph.microsoft.com/v1.0/me/messages/{id}/send

C#

// Code snippets are only available for the latest version. Current version is 5.x

var graphClient = new GraphServiceClient(requestAdapter);

await graphClient.Me.Messages["{message-id}"].Send.PostAsync();

Дополнительные сведения о добавлении пакета SDK в проект и создании экземпляра authProvider см. в документации по пакету SDK.

Go

import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



graphClient.Me().Messages().ByMessageId("message-id").Send().Post(context.Background(), nil)

Дополнительные сведения о добавлении пакета SDK в проект и создании экземпляра authProvider см. в документации по пакету SDK.

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

graphClient.me().messages("{id}")
	.send()
	.buildRequest()
	.post();

Дополнительные сведения о добавлении пакета SDK в проект и создании экземпляра authProvider см. в документации по пакету SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/me/messages/{id}/send')
	.post();

Дополнительные сведения о добавлении пакета SDK в проект и создании экземпляра authProvider см. в документации по пакету SDK.

PHP

<?php

// THIS SNIPPET IS A PREVIEW FOR THE KIOTA BASED SDK. NON-PRODUCTION USE ONLY
$graphServiceClient = new GraphServiceClient($requestAdapter);


$graphServiceClient->me()->messages()->byMessageId('message-id')->send()->post();

Дополнительные сведения о добавлении пакета SDK в проект и создании экземпляра authProvider см. в документации по пакету SDK.

PowerShell

Import-Module Microsoft.Graph.Users.Actions

# A UPN can also be used as -UserId.
Send-MgUserMessage -UserId $userId -MessageId $messageId

Дополнительные сведения о добавлении пакета SDK в проект и создании экземпляра authProvider см. в документации по пакету SDK.

Отклик

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

HTTP/1.1 202 Accepted