Freigeben über

message: createReplyAll

  • Artikel

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.

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 Nachrichtenentwurf später aktualisieren .

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. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Content-Type string Die Art der Daten im Textkörper einer Entität. Erforderlich.
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

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 Antwort-alle-Nachricht 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.

Antwort

Bei erfolgreicher Ausführung der Methode 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 Entwurfs im JSON-Format zum Antworten auf eine vorhandene Nachricht

Im folgenden Beispiel wird ein Entwurf erstellt, der allen antworten soll, und es werden eine Anlage und ein Kommentar in einem createReplyAll-Aufruf hinzugefügt.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

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

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

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#Me/messages/$entity",
  "@odata.id": "https://graph.microsoft.com/beta/users('86b6ceaf-57f7-4278-97c4-4da0a97f6cdb@70559e59-b378-49ea-8e53-07a3a3d27f5b')/messages('AAMkADA1MTAAAH5JKpAAA=')",
  "@odata.etag": "W/\"CQAAABYAAADX8oL1Wa7jQbcPAHouCzswAAAH5/DP\"",
  "id": "AAMkADA1MTAAAH5JKpAAA=",
  "subject": "RE: Let's start a group",
  "body": {
    "contentType": "HTML",
    "content": "<html>\r\n<body dir=\"ltr\">\r\nif the project gets approved, please take a look at the attached guidelines before you decide on the name.\r\n<b>From:</b> Admin<br>\r\n<b>Sent:</b> Tuesday, March 15, 2016 6:36:32 AM<br>\r\n<b>To:</b> Samantha Booth; Randi Welch<br>\r\n<b>Subject:</b> RE: Let's start a group\r\n<div>Samantha, Randi, would you name the group please?\r\n<b>From:</b> Samantha Booth<br>\r\n<b>Sent:</b> Friday, March 4, 2016 12:23:35 AM<br>\r\n<b>To:</b> Admin<br>\r\n<b>Subject:</b> Re: Let's start a group</font>\r\n</body>\r\n</html>"
  },
  "sender": {
    "emailAddress": {
      "name": "Admin",
      "address": "admin@contoso.com"
    }
  },
  "from": null,
  "toRecipients": [
    {
      "emailAddress": {
        "name": "Samantha Booth",
        "address": "samanthab@contoso.com"
      }
    },
    {
      "emailAddress": {
        "name": "Randi Welch",
        "address": "randiw@contoso.com"
      }
    }
  ]
}

Beispiel 2: Erstellen eines Entwurfs mithilfe des MIME-Formats zum Antworten auf eine vorhandene Nachricht

POST https://graph.microsoft.com/beta/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."
    }
}