message: reply

Namespace: microsoft.graph.

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Dem Absender einer Nachricht entweder im JSON- oder MIME-Format antworten.

Bei Verwendung des JSON-Formats:

  • Geben Sie entweder einen Kommentar oder die body-Eigenschaft des message Parameters an. Wenn Sie beide Optionen angeben, wird ein HTTP-Fehler 400 Bad Request zurückgegeben.
  • Wenn die ursprüngliche Nachricht einen Empfänger in der replyTo-Eigenschaft gemäß Internet Message Format (RFC 2822) angibt, senden Sie die Antwort an die Empfänger in replyTo und nicht an den Empfänger in der from-Eigenschaft.

Bei Verwendung des MIME-Formats:

  • Geben Sie die entsprechenden Internetnachrichtenkopfzeilen und den MIME-Inhalt an, die im Anforderungstext alle im Base64-Format codiert sind.
  • Fügen Sie dem MIME-Inhalt sämtliche Anlagen und S/MIME-Eigenschaften hinzu.

Bei dieser Methode wird die Nachricht im Ordner Gesendete Elemente gespeichert.

Alternativ können Sie einen Entwurf erstellen, um auf eine Nachricht zu antworten, und ihn später senden .

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Mail.Send Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Mail.Send Nicht verfügbar.
Anwendung Mail.Send Nicht verfügbar.

HTTP-Anforderung

POST /me/messages/{id}/reply
POST /users/{id | userPrincipalName}/messages/{id}/reply
POST /me/mailFolders/{id}/messages/{id}/reply
POST /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/reply

Anforderungsheader

Name Typ Beschreibung
Authorization string Bearer {token}. Erforderlich
Content-Type string Die Art der Daten im Textkörper einer Entität. Erforderlich
Wird für ein JSON-Objekt und text/plain für MIME-Inhalt verwendet application/json
Prefer: outlook.timezone string Legt die Zeitzone für das Sent Feld der Antwortnachricht in HTML fest, die diese API basierend auf dem Anforderungstext erstellt. Der Wert kann eine der für den Benutzer konfigurierten supportedTimeZones sein. Wenn nicht angegeben, befindet sich dieses Sent Feld in UTC.

Verwenden Sie diesen Header nur, wenn Sie den Content-Type: application/json Header zum Erstellen der Antwortnachricht in HTML angeben. Wenn Sie die Content-Type: text/plain Überschrift verwenden, hat diese Prefer Überschrift keine Auswirkung. Optional.

Anforderungstext

Wenn Sie das JSON-Format verwenden, fügen Sie ein JSON-Objekt mit den folgenden Parametern ein.

Parameter Typ Beschreibung
comment String Ein Kommentar, der eingefügt werden kann. Kann eine leere Zeichenfolge sein.
message Nachricht Alle beschreibbaren Eigenschaften, die in der Antwortnachricht aktualisiert werden sollen.

Wenn Sie den Text im MIME-Format angeben, geben Sie den MIME-Inhalt mit den entsprechenden Internetnachrichtenheadern an, die alle im Base64-Format im Anforderungstext codiert sind. Bei dieser Methode wird der Absender der ursprünglichen Nachricht als Empfänger verwendet.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 202 Accepted zurückgegeben. Sie gibt nichts im Antworttext zurück.

Wenn der Anforderungstext falsch formatierten MIME-Inhalt enthält, gibt diese Methode einen 400 Bad Request Antwortcode und die folgende Fehlermeldung zurück: "Invalid base64 string for MIME content".

Beispiele

Beispiel 1: Antworten auf eine Nachricht im JSON-Format

Das folgende Beispiel fügt einen Kommentar hinzu und fügt der Antwortnachricht einen Empfänger hinzu.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/me/messages/AAMkADA1MTAAAAqldOAAA=/reply
Content-Type: application/json

{
  "message":{
    "toRecipients":[
      {
        "emailAddress": {
          "address":"samanthab@contoso.com",
          "name":"Samantha Booth"
        }
      },
      {
        "emailAddress":{
          "address":"randiw@contoso.com",
          "name":"Randi Welch"
        }
      }
     ]
  },
  "comment": "Samantha, Randi, would you name the group please?"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 202 Accepted

Beispiel 2: Antworten auf eine Nachricht im MIME-Format

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/v1.0/me/messages/AAMkADA1MTAAAAqldOAAA=/reply
Content-Type: text/plain

UmVjZWl2ZWQ6IGZyb20gY29udG9zby5jb20gKDEwLjE5NC4yNDEuMTk3KSBieSAKY29udG9zby5jb20gKDEwLjE5NC4yNDEuMTk3KSB3aXRoIE1pY3Jvc29mdCAKU01UUCBTZXJ2ZXIgKHZlcnNpb249VExTMV8yLCAKY2lwaGVyPVRMU19FQ0RIRV9SU0FfV0lUSF9BRVNfMjU2X0NCQ19TSEEzODRfUDI1NikgaW

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 202 Accepted

Wenn der Anforderungstext falsch formatierten MIME-Inhalt enthält, gibt diese Methode die folgende Fehlermeldung an.

HTTP/1.1 400 Bad Request
Content-type: application/json

{
    "error": {
        "code": "ErrorMimeContentInvalidBase64String",
        "message": "Invalid base64 string for MIME content."
    }
}