message: replyAll

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.

Allen Empfängern 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 400 Bad Request-Fehler 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 allen 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}/replyAll
POST /users/{id | userPrincipalName}/messages/{id}/replyAll
POST /me/mailFolders/{id}/messages/{id}/replyAll
POST /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/replyAll

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

Geben Sie bei Verwendung des JSON-Formats ein JSON-Objekt mit den folgenden Parametern an.

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 werden der Absender und alle Empfänger der ursprünglichen Nachricht als Empfänger der neuen Nachricht geladen.

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 400 Bad request sowie die folgende Fehlermeldung an: „Ungültige Base64-Zeichenfolge für MIME-Inhalt“.

Beispiele

Beispiel 1: Allen antworten auf eine Nachricht im JSON-Format

Das folgende Beispiel fügt einen Kommentar hinzu und fügt der Alle-Antwort-Nachricht eine Anlage hinzu.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

{
    "message":{
      "attachments": [
        {
          "@odata.type": "#microsoft.graph.fileAttachment",
          "name": "guidelines.txt",
          "contentBytes": "bWFjIGFuZCBjaGVlc2UgdG9kYXk="
        }
      ]
    },
    "comment": "Please take a look at the attached guidelines before you decide on the name."
}
Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 202 Accepted

Beispiel 2: Allen antworten auf eine Nachricht im MIME-Format

Anforderung
POST https://graph.microsoft.com/beta/me/messages/AAMkADA1MTAAAH5JaLAAA=/replyAll
Content-Type: text/plain

RnJvbTogQWxleCBXaWxiZXIgPEFsZXhXQGNvbnRvc28uY29tPgpUbzogTWVnYW4gQm93ZW4gPE1l
Z2FuQkBjb250b3NvLmNvbT4KU3ViamVjdDogSW50ZXJuYWwgUmVzdW1lIFN1Ym1pc3Npb246IFNh
bGVzIEFzc29jaWF0ZQpUaHJlYWQtVG9waWM...

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."
    }
}