message: createReplyAll

  • Artikel

Namespace: microsoft.graph

Erstellen Sie einen Entwurf, um dem Absender und allen Empfängern einer Nachricht im JSON- oder MIME-Format zu antworten.

Bei Verwendung des JSON-Formats:

  • Geben Sie entweder einen Kommentar oder die body-Eigenschaft des message Parameters an. Wenn Sie beide angeben, wird der Fehler HTTP 400 Bad Request zurückgegeben.
  • Wenn die ursprüngliche Nachricht einen Empfänger in der replyTo-Eigenschaft pro Internetnachrichtenformat (RFC 2822) angibt, sollten Sie die Antwort an die Empfänger in den Eigenschaften replyTo und toRecipients senden, nicht an die Empfänger in den Eigenschaften from und toRecipients .
  • Sie können den Entwurf später aktualisieren , um dem Textkörper Antwortinhalte hinzuzufügen oder andere Nachrichteneigenschaften zu ändern.

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.

Senden Sie den Nachrichtentwurf in einem nachfolgenden Vorgang.

Alternativ können Sie in einer einzelnen Aktion auf eine Nachricht antworten .

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

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ✅ ✅ ✅

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. 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.ReadWrite Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Mail.ReadWrite Nicht verfügbar.
Anwendung Mail.ReadWrite Nicht verfügbar.

HTTP-Anforderung

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

Anforderungsheader

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

Verwenden Sie diesen Header nur, wenn Sie den Content-Type: application/json Header angeben, um die Antwortentwurfsnachricht in HTML zu erstellen. Wenn Sie den Content-Type: text/plain -Header verwenden, hat dieser Prefer Header keine Auswirkung. Optional.

Anforderungstext

Für diese Methode ist kein Anforderungstext erforderlich.

Wenn Sie jedoch einen replyAll-Entwurf im MIME-Format erstellen möchten, stellen Sie den MIME-Inhalt mit den entsprechenden Internetnachrichtenheadern bereit, die alle im Base64-Format im Anforderungstext codiert sind.

Antwort

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 201 Created und das Message-Objekt im Antworttext zurückgegeben.

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: Erstellen eines Nachrichtenentwurfs im JSON-Format zum Antworten auf eine vorhandene Nachricht

Nachfolgend sehen Sie ein Beispiel dafür, wie diese API aufgerufen wird.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

Das folgende Beispiel zeigt die Antwort. Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt sein.

HTTP/1.1 200 OK
Content-type: application/json

{
  "receivedDateTime": "datetime-value",
  "sentDateTime": "datetime-value",
  "hasAttachments": true,
  "subject": "subject-value",
  "body": {
    "contentType": "",
    "content": "content-value"
  },
  "bodyPreview": "bodyPreview-value"
}

Beispiel 2: Erstellen eines Nachrichtenentwurfs im MIME-Format zum Antworten auf eine vorhandene Nachricht

Anforderung
POST https://graph.microsoft.com/v1.0/me/messages/AAMkADA1MTAAAH5JaLAAA=/createReplyAll
Content-type: text/plain

Q29udGVudC1UeXBlOiBhcHBsaWNhdGlvbi9wa2NzNy1taW1lOw0KCW5hbWU9c21pbWUucDdtOw0KCXNtaW1lLXR5cGU9ZW52ZWxvcGVkLWRhdGENCk1pbWUtVmVyc2lvbjogMS4wIChNYWMgT1MgWCBNYWlsIDEzLjAgXCgzNjAxLjAuMTBcKSkNClN1YmplY3Q6IFJlOiBUZXN0aW5nIFMvTUlNRQ0KQ29udGVudC1EaXNwb3Np
Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('0aaa0aa0-0000-0a00-a00a-0000009000a0')/messages/$entity",
    "@odata.etag": "W/\"AAAAAAAAAAAa00AAAa0aAaAa0a0AAAaAAAAaAa0a\"",
    "id": "AAMkADA1MTAAAAqldOAAA=",
    "createdDateTime": "2021-04-23T18:13:44Z",
    "lastModifiedDateTime": "2021-04-23T18:13:44Z",
    "changeKey": "AAAAAAAAAAAA00aaaa000aaA",
    "categories": [],
    "receivedDateTime": "2021-04-23T18:13:44Z",
    "sentDateTime": "2021-02-28T07:15:00Z",
    "hasAttachments": false,
    "internetMessageId": "<AAAAAAAAAA@AAAAAAA0001AA0000.codcod00.prod.outlook.com>",
    "subject": "Internal Resume Submission: Sales Associate",
    "bodyPreview": "Hi, Megan.I have an interest in the Sales Associate position. Please consider my resume, which you can access here...",
    "importance": "normal",
    "parentFolderId": "LKJDSKJHkjhfakKJHFKWKKJHKJdhkjHDK==",
    "conversationId": "SDSFSmFSDGI5LWZhYjc4fsdfsd=",
    "conversationIndex": "Adfsdfsdfsdfw==",
    "isDeliveryReceiptRequested": null,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": true,
    "webLink": "https://outlook.office365.com/owa/?ItemID=AAMkAGNhOWAvsurl=1&viewmodel=ReadMessageItem",
    "inferenceClassification": "focused",
    "body": {
        "contentType": "text",
        "content": "Hi, Megan.I have an interest in the Sales Associate position. Please consider my resume, which you can access here... Regards,Alex"
    },
    "sender": {
        "emailAddress": {
            "name": "Alex Wilber",
            "address": "AlexW@contoso.com"
        }
    },
    "from": {
        "emailAddress": {
            "name": "Alex Wilber",
            "address": "AlexW@contoso.com"
        }
    },
    "toRecipients": [
        {
            "emailAddress": {
                "name": "Megan Bowen",
                "address": "MeganB@contoso.com"
            }
        }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "flag": {
        "flagStatus": "notFlagged"
    }
}

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