Nachricht sendenSend mail

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Sendet die im Anforderungstext angegebene Nachricht. Die Nachricht wird dann automatisch im Ordner „Gesendete Elemente“ gespeichert.Send the message specified in the request body. The message is saved in the Sent Items folder by default.

Im gleichen sendmail -Aktionsaufruf haben Sie folgende Möglichkeiten:In the same sendMail action call, you can:

  • Einschließen einer AnlageInclude an attachment
  • Verwenden einer Erwähnung zum Aufrufen eines anderen Benutzers in der neuen NachrichtUse a mention to call out another user in the new message

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Mail.SendMail.Send
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Mail.SendMail.Send
AnwendungApplication Mail.SendMail.Send

HTTP-AnforderungHTTP request

POST /me/sendMail
POST /users/{id | userPrincipalName}/sendMail

AnforderungsheaderRequest headers

KopfzeileHeader WertValue
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

AnforderungstextRequest body

Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.In the request body, provide a JSON object with the following parameters.

ParameterParameter TypType BeschreibungDescription
NachrichtMessage NachrichtMessage Die zu sendende Nachricht. Erforderlich. The message to send. Required.
SaveToSentItemsSaveToSentItems BooleschBoolean ,Gibt an, ob die Nachricht im Ordner „Gesendete Elemente“ gespeichert werden soll. Geben Sie es nur an, wenn der Parameter false ist; der Standardwert true ist. Optional.Indicates whether to save the message in Sent Items. Specify it only if the parameter is false; default is true. Optional.

Wenn Sie mention verwenden möchten, um einen anderen Benutzer in der neuen Nachricht auszurufen:If you want to use mention to call out another user in the new message:

  • Schließen Sie die **** erforderliche torecipients-Eigenschaft, die Mentions -Eigenschaft und alle beschreibbaren Nachrichteneigenschaften im Anforderungstext ein.Include the required toRecipients property, the mentions property, and any writable message properties in the request body.
  • Für jede Erwähnung in **** der Mentions-Eigenschaft müssen Sie die erwähnte Eigenschaft angeben.For each mention in the mentions property, you must specify the mentioned property.

AntwortResponse

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 202 Accepted zurückgegeben. Im Antworttext wird nichts zurückgegeben.If successful, this method returns 202 Accepted response code. It does not return anything in the response body.

BeispielExample

Nachfolgend sehen Sie ein Beispiel dafür, wie diese API aufgerufen wird.Here is an example of how to call this API.

Anforderung 1Request 1

Im folgenden finden Sie ein Beispiel für die Anforderung zum spontanen erstellen und Senden einer Nachricht.Here is an example of the request to create and send a message on the fly.

POST https://graph.microsoft.com/beta/me/sendMail
Content-type: application/json
Content-length: 512

{
  "message": {
    "subject": "Meet for lunch?",
    "body": {
      "contentType": "Text",
      "content": "The new cafeteria is open."
    },
    "toRecipients": [
      {
        "emailAddress": {
          "address": "samanthab@contoso.onmicrosoft.com"
        }
      }
    ],
    "ccRecipients": [
      {
        "emailAddress": {
          "address": "danas@contoso.onmicrosoft.com"
        }
      }
    ]
  },
  "saveToSentItems": "false"
}
Antwort 1Response 1

Nachfolgend sehen Sie ein Beispiel der Antwort.Here is an example of the response.

HTTP/1.1 202 Accepted
Anforderung 2Request 2

Das nächste Beispiel zeigt eine Nachricht des angemeldeten Benutzers an Samantha Booth.The next example shows a message by the signed-in user to Samantha Booth. Die Nachricht enthält auch eine Erwähnung eines anderen Benutzers, Dana Swope.The message also includes a mention of another user, Dana Swope.

POST https://graph.microsoft.com/beta/me/sendMail
Content-type: application/json
Content-length: 344

{
  "Message": {
    "subject": "Project kickoff",
    "toRecipients":[
      {
          "emailAddress":{
              "name":"Samantha Booth",
              "address":"samanthab@contoso.onmicrosoft.com"
          }
      }
    ],
    "mentions":[
      {
        "mentioned":{
          "name":"Dana Swope",
          "address":"danas@contoso.onmicrosoft.com"
         }
      }
    ]
  }
}
Antwort 2Response 2

Nachfolgend sehen Sie ein Beispiel der Antwort.Here is an example of the response.

HTTP/1.1 202 Accepted
Anforderung 3Request 3

Im nächsten Beispiel wird eine Nachricht mit benutzerdefinierten Internetkopfzeilen erstellt, und die Nachricht wird gesendet.The next example creates a message with custom Internet message headers and sends the message.

POST https://graph.microsoft.com/beta/me/sendMail
Content-type: application/json

{
  "message": {
    "subject": "9/9/2018: concert",
    "body": {
      "contentType": "HTML",
      "content": "The group represents Nevada."
    },
    "toRecipients": [
      {
        "emailAddress": {
          "address": "AlexW@contoso.OnMicrosoft.com"
        }
      }
    ],
    "internetMessageHeaders":[
      {
        "name":"x-custom-header-group-name",
        "value":"Nevada"
      },
      {
        "name":"x-custom-header-group-id",
        "value":"NV001"
      }
    ]
  }
}
Antwort 3Response 3

Nachfolgend sehen Sie ein Beispiel der Antwort.Here is an example of the response.

HTTP/1.1 202 Accepted