Outlook-Mail-REST-API-Verweis (Version 1.0)

  • Artikel

Gilt für: Exchange Online | Office 365 | Hotmail.com | Live.com | MSN.com | Outlook.com | Passport.com

Hinweis

Version 1.0 der Outlook REST-API ist veraltet. Ab dem 1. November 2018 können Apps die Standardauthentifizierung nicht mehr mit dem REST-Endpunkt v1.0 verwenden. Ab dem 1. November 2019 wird der v1.0 REST-Endpunkt vollständig stillgelegt und die v1.0-Dokumentation kurz darauf entfernt. Starten Sie die Migration Ihrer App zur Verwendung der Outlook REST-API in v1.0 von Microsoft Graph. Weitere Details finden Sie in unserer Ankündigung.

Mit der Outlook Mail-API können Sie Nachrichten und Anhänge lesen, erstellen und senden, Ereignisnachrichten anzeigen und beantworten sowie Ordner verwalten, die durch Azure Active Directory in Office 365 geschützt sind. Sie bietet die gleiche Funktionalität in Microsoft-Konten speziell in diesen Domänen: Hotmail.com, Live.com, MSN.com, Outlook.com und Passport.com.

Hinweis

Zur Vereinfachung des Verweises verwendet der Rest dieses Artikels Outlook.com, um diese Microsoft-Konto-Domänen mit einzuschließen.

Kein Interesse an v1.0 der API? Wechseln Sie im Inhaltsverzeichnis auf der linken Seite zu Office 365-REST-API-Referenz und wählen Sie die gewünschte Version aus.

Alle Mail-API-Operationen

Nachrichtenvorgänge

Nachrichten werden in Postfachordnern gespeichert, sodass Nachrichtenendpunkte häufig den Ordner enthalten, der die Nachricht enthält. Ein Ordner wird entweder durch die ID oder durch einen der folgenden bekannten Ordnernamen spezifiziert: Inbox, Drafts, SentItems, oder DeletedItems.

Ordnervorgänge

Postfach-Ordner können Nachrichten und andere Ordner enthalten. Sie können Ordner abrufen, erstellen, ändern, löschen und verwalten. Sie können die folgenden bekannten Ordnernamen anstelle der ID verwenden, um den entsprechenden Ordner anzugeben: Inbox, SentItems, Drafts, oder DeletedItems.

Siehe auch

Verwenden der Mail-REST-API

Authentifizierung

Wie andere Outlook-REST-API, sollten Sie für jede Anforderung an die Mail-API ein gültiges Zugriffstoken angeben. Um ein Zugriffstoken zu erhalten, müssen Sie sich registriert und Ihre App identifiziert und die entsprechende Autorisierung erhalten haben.

Sie können mehr über einige optimierte Registrierungs- und Autorisierungsoptionen für Sie herausfinden. Beachten Sie dies, wenn Sie mit den spezifischen Operationen in der Mail-API fortfahren.

Version der API

Die Mail-REST-API wird in allen Versionen der Outlook-REST-API unterstützt. Die Funktionalität kann je nach spezifischer Version unterschiedlich sein.

Ziel-Benutzer

Alle Mail-API-Anfragen werden im Namen des angemeldeten Benutzers ausgeführt, sofern nicht anders angegeben. Einige API-Teilmengen, wie z.B. die Posteingang mit Relevanz-API, können für den angemeldeten Benutzer oder einen durch eine Benutzer-ID spezifizierten Benutzer mit den entsprechenden Berechtigungen ausgeführt werden.

Weitere Informationen, die allen Untergruppen von Outlook-REST-API gemeinsam sind, finden Sie unter Outlook-REST-API verwenden.

Nachrichten abrufen

Sie können eine Nachrichtensammlung oder eine einzelne Nachricht aus einem Postfachordner abrufen.

Jede Nachricht in der Antwort enthält mehrere Eigenschaften, darunter auch die Text-Eigenschaft. Der Nachrichtentext kann entweder Text oder HTML sein. Wenn der Textkörper im HTML-Format vorliegt, werden standardmäßig alle potenziell unsicheren HTML-Elemente (z. B. JavaScript), die in der body-Eigenschaft eingebettet sind, vor dem Zurückgeben des Textkörperinhalts in einer REST-Antwort entfernt.

Fügen Sie den gesamten, ursprünglichen HTML-Inhalt ein, um den folgenden HTTP-Anforderungs-Header abzurufen:

Prefer: outlook.allow-unsafe-html

Zurzeit gibt der GET-Vorgang Nachrichtentext ausschließlich im HTML-Format zurück.

Eine Nachrichtensammlung abrufen

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Hinweis

Das Verhalten der Vorgänge in diesem Abschnitt hängt von der Version ab. Erfahren Sie mehr, indem Sie eine Version unter Office 365 REST-API-Referenz im Inhaltsverzeichnis auf der linken Seite auswählen.

Eine Nachrichtensammlung aus dem Posteingang abrufen.

GET https://outlook.office.com/api/v1.0/me/messages

Sie können auch einen Ordner im Postfach des Benutzers angeben und die Nachrichtensammlung aus diesem Ordner abrufen.

GET https://outlook.office.com/api/v1.0/me/MailFolders/{folder_id}/messages
Erforderliche Parameter Typ Beschreibung
URL-Parameter
folder_id Zeichenfolge Die Ordner-ID oder die Inbox, Drafts, SentItems, oder DeletedItems bekannter Ordnername, wenn Sie Nachrichten aus einem bestimmten Ordner erhalten.

Hinweis

Standardmäßig umfasst jede Nachricht in der Antwort alle ihre Eigenschaften. Verwenden Sie $select, um nur die Eigenschaften anzugeben, die Sie für die beste Leistung benötigen. Die ID-Eigenschaft wird immer zurückgegeben. Siehe OData Abfrage-Parameter für Filter-, Sortier- und Paging-Parameter.

Das folgende Beispiel zeigt, wie man $select verwendet, um nur die Eigenschaften Sender und Thema jeder Nachricht in der Antwort anzugeben. Lesen Sie die Beispielantwort Eine Nachricht abrufen für eine vollständige Liste der Eigenschaften, die für eine Nachricht zurückgegeben werden würden, wenn Sie nicht $select verwenden.

Beispielanfrage

GET https://outlook.office.com/api/v1.0/me/folders/sentitems/messages/?$select=Sender,Subject

Beispielantwort

Statuscode: 200

{
    "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Folders('sentitems')/Messages(Sender,Subject)",
    "value": [
        {
            "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Messages('AAMkAGI2TIy-AAA=')",
            "@odata.etag": "W/\"CQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTJqS\"",
            "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEJAACd9nJ-tVysQos2hTfspaWRAAADTIzAAAA=",
            "Subject": "Meeting Notes",
            "Sender": {
                "EmailAddress": {
                    "Name": "Alex D",
                    "Address": "/O=EXCHANGELABS/OU=EXCHANGE ADMINISTRATIVE GROUP (FYDIBOHF23SPDLT)/CN=RECIPIENTS/CN=1A5F1737122542AEA595DF9590A1C6FD-ALEXD"
                }
            }
        },
        {
            "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Messages('AAMkAGI2TIy-AAA=')",
            "@odata.etag": "W/\"CQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTJqP\"",
            "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEJAACd9nJ-tVysQos2hTfspaWRAAADTIy-AAA=",
            "Subject": "Contract Signing",
            "Sender": {
                "EmailAddress": {
                    "Name": "Alex D",
                    "Address": "/O=EXCHANGELABS/OU=EXCHANGE ADMINISTRATIVE GROUP (FYDIBOHF23SPDLT)/CN=RECIPIENTS/CN=1A5F1737122542AEA595DF9590A1C6FD-ALEXD"
                }
            }
        },
        {
            "@odata.type": "#Microsoft.OutlookServices.EventMessage",
            "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Messages('AAMkAGI2TIy-AAA=')",
            "@odata.etag": "W/\"CwAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTJqJ\"",
            "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEJAACd9nJ-tVysQos2hTfspaWRAAADTIy9AAA=",
            "Subject": "Rob:Alex 1:1",
            "Sender": {
                "EmailAddress": {
                    "Name": "Alex D",
                    "Address": "/O=EXCHANGELABS/OU=EXCHANGE ADMINISTRATIVE GROUP (FYDIBOHF23SPDLT)/CN=RECIPIENTS/CN=1A5F1737122542AEA595DF9590A1C6FD-ALEXD"
                }
            }
        }
    ]
}

Antworttyp

Die angeforderte Nachrichten-Sammlung.

Abrufen einer Nachricht

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Eine Nachricht nach ID abrufen.

GET https://outlook.office.com/api/v1.0/me/messages/{message_id}
Erforderliche Parameter Typ Beschreibung
URL-Parameter
message_id Zeichenfolge Die Nachrichten-ID.

Beispielanfrage

GET https://outlook.office.com/api/v1.0/me/messages/AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEMAACd9nJ-tVysQos2hTfspaWRAAADTHVSAAA=

Beispielantwort

Statuscode: 200

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "@odata.etag": "W/\"CQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIKz\"",
  "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEMAACd9nJ-tVysQos2hTfspaWRAAADTHVSAAA=",
  "ChangeKey": "CQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIKz",
  "Categories": [],
  "DateTimeCreated": "2014-10-20T00:41:57Z",
  "DateTimeLastModified": "2014-10-20T00:41:57Z",
  "Subject": "Re: Meeting Notes",
  "BodyPreview": "________________________________________\nFrom: Alex D\nSent: Sunday, October 19, 2014 5:28 PM\nTo: Katie Jordan\nSubject: Meeting Notes\n\nPlease send me the meeting notes ASAP",
  "Body": {
    "ContentType": "Text",
    "Content": "\n________________________________________\nFrom: Alex D\nSent: Sunday, October 19, 2014 5:28 PM\nTo: Katie Jordan\nSubject: Meeting Notes\n\nPlease send me the meeting notes ASAP\n"
  },
  "Importance": "Normal",
  "HasAttachments": true,
  "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEMAAA=",
  "From": {
    "EmailAddress": {
      "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Katie Jordan"
    }
  },
  "Sender": {
    "EmailAddress": {
      "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Katie Jordan"
    }
  },
  "ToRecipients": [
    {
      "EmailAddress": {
        "Address": "alexd@a830edad9050849NDA1.onmicrosoft.com",
        "Name": "Alex D"
      }
    }
  ],
  "CcRecipients": [],
  "BccRecipients": [],
  "ReplyTo": [],
  "ConversationId": "AAQkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAQAEmjRj3pwjRLrbymGMYyEto=",
  "DateTimeReceived": "2014-10-20T00:41:57Z",
  "DateTimeSent": "2014-10-20T00:41:53Z",
  "IsDeliveryReceiptRequested": false,
  "IsReadReceiptRequested": false,
  "IsDraft": false,
  "IsRead": false
}

Antworttyp

Die gewünschte Nachricht.

Hinweis

Standardmäßig enthält die Antwort alle Eigenschaften der angegebenen Nachricht. Verwenden Sie $select, um nur die Eigenschaften anzugeben, die Sie für die beste Leistung benötigen. Die ID-Eigenschaft wird immer zurückgegeben. Siehe OData Abfrage-Parameter für Filter-, Sortier- und Paging-Parameter.

Das folgende Beispiel zeigt, wie man $select verwendet, um nur die Eigenschaften Sender und Thema jeder Nachricht in der Antwort anzugeben.

GET https://outlook.office.com/api/v1.0/me/messages/AAMkAGEI5MTAAA=?$select=Sender,Subject

Nachrichten synchronisieren

Dieses Feature ist derzeit nur in v2.0 und der Beta-Version verfügbar. Um mehr zu erfahren, gehen Sie im Inhaltsverzeichnis auf der linken Seite zum Abschnitt Office 365-REST-API-Referenz und wählen Sie eine der beiden Versionen.

Nachrichten erstellen und versenden

Sie können eine neue Nachricht spontan versenden oder eine Entwurfsnachricht erstellen und dann versenden. Sie können Entwürfe in einem beliebigen Ordner erstellen.

Spontan eine neue Nachricht versenden

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Senden Sie die Nachricht, die Sie im Anforderungstext erhalten haben, indem Sie die Methode SendMail verwenden. Sie können einen oder mehrere Anlagen in denselben Aktionsaufruf aufnehmen, indem Sie sie in der Sammlungseigenschaft Attachments angeben. Sie können auch die Nachricht im Ordner „Gesendete Elemente“ speichern.

POST https://outlook.office.com/api/v1.0/me/sendmail
Erforderliche Parameter Typ Beschreibung
Textkörper-Parameter
Nachricht Nachricht Die zu sendende Nachricht.
SaveToSentItems boolesch Gibt an, ob die Nachricht in „Gesendete Elemente“ gespeichert werden soll. Der Standardwert ist True.

Geben Sie den Parameter Message mit der erforderlichen Eigenschaft ToRecipients und allen beschreibbaren Eigenschaften Message im Anforderungstext an. Der Parameter SaveToSentItems wird nur benötigt, wenn false.

Beispielanfrage

POST https://outlook.office.com/api/v1.0/me/sendmail

{
  "Message": {
    "Subject": "Meet for lunch?",
    "Body": {
      "ContentType": "Text",
      "Content": "The new cafeteria is open."
    },
    "ToRecipients": [
      {
        "EmailAddress": {
          "Address": "garthf@a830edad9050849NDA1.onmicrosoft.com"
        }
      }
    ],
    "Attachments": [
      {
        "@odata.type": "#Microsoft.OutlookServices.FileAttachment",
        "Name": "menu.txt",
        "ContentBytes": "bWFjIGFuZCBjaGVlc2UgdG9kYXk="
      }
    ]
  },
  "SaveToSentItems": "false"
}

Beispielantwort

Status code: 202

Einen Nachrichtenentwurf erstellen

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Erstellt einen Entwurf einer neuen Nachricht. Entwürfe können in einem beliebigen Ordner erstellt und vor dem Versand optional aktualisiert werden. Um in den Ordner Entwürfe zu speichern, verwenden Sie die Verknüpfung /me/messages.

POST https://outlook.office.com/api/v1.0/me/messages
POST https://outlook.office.com/api/v1.0/me/folders/{folder_id}/messages
Erforderliche Parameter Typ Beschreibung
URL-Parameter
folder_id Zeichenfolge Die Zielordner-ID oder der Inbox oder Drafts der bekannte Ordnername

Geben Sie alle beschreibbaren Nachrichten-Eigenschaften im Anforderungstext an.

Beispielanfrage

POST https://outlook.office.com/api/v1.0/me/folders/inbox/messages

Content-Type: application/json

{
  "Subject": "Did you see last night's game?",
  "Importance": "Low",
  "Body": {
    "ContentType": "HTML",
    "Content": "They were <b>awesome</b>!"
  },
  "ToRecipients": [
    {
      "EmailAddress": {
        "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com"
      }
    }
  ]
}

Beispielantwort

Statuscode: 201

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "@odata.etag": "W/\"CQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAS0Ag5\"",
  "Id": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MABGAAAAAAC_0WfqSjt_SqLtNkuO-bj1BwAmP1Ln1wcHRariNdTMGAO9AAAAAAEPAAAmP1Ln1wcHRariNdTMGAO9AAASz7k0AAA=",
  "ChangeKey": "CQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAS0Ag5",
  "Categories": [],
  "DateTimeCreated": "2014-10-18T20:06:51Z",
  "DateTimeLastModified": "2014-10-18T20:06:51Z",
  "Subject": "Did you see last night's game?",
  "BodyPreview": "They were awesome!",
  "Body": {
    "ContentType": "HTML",
    "Content": "<html>\r\n<head>\r\n<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\r\n</head>\r\n<body>\r\nThey were <b>awesome</b>!\r\n</body>\r\n</html>\r\n"
  },
  "Importance": "Low",
  "HasAttachments": false,
  "ParentFolderId": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAAAAAEPAAA=",
  "From": null,
  "Sender": null,
  "ToRecipients": [
    {
      "EmailAddress": {
        "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com",
        "Name": "Katie Jordan"
      }
    }
  ],
  "CcRecipients": [],
  "BccRecipients": [],
  "ReplyTo": [],
  "ConversationId": "AAQkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAQADXiGXoAtX9IubRTpv2hisc=",
  "DateTimeReceived": "2014-10-18T20:06:51Z",
  "DateTimeSent": "2014-10-18T20:06:51Z",
  "IsDeliveryReceiptRequested": false,
  "IsReadReceiptRequested": false,
  "IsDraft": true,
  "IsRead": true
}

Antworttyp

Der Entwurf der Nachricht.

Einen Nachrichtenentwurf versenden

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Versenden Sie einen neuen Nachrichtenentwurf, einen Antwortentwurf, einen Allen antworten-Entwurf oder einen Weiterleitungsentwurf unter Verwendung der Senden-Methode. Eine Kopie der Nachricht wird im Ordner „Gesendete Elemente“ gespeichert.

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/send
Erforderliche Parameter Typ Beschreibung
URL-Parameter
message_id Zeichenfolge Die ID des zu sendenden Nachrichtenentwurfs.

Beispielanfrage

POST https://outlook.office.com/api/v1.0/me/messages/AAMkAGE0Mz7k0AAA=/send

Beispielantwort

Status code: 202

Auf Nachrichten antworten oder alle beantworten

Hinweis

Das Verhalten der Vorgänge in diesem Abschnitt hängt von der Version ab. Erfahren Sie mehr, indem Sie eine Version unter Office 365 REST-API-Referenz im Inhaltsverzeichnis auf der linken Seite auswählen.

Sie können mit einem Kommentar zur Laufzeit antworten, oder Sie können zuerst einen Antwortentwurf erstellen, dann den Entwurf aktualisieren und versenden.

Sie können nur an den Absender der Nachricht oder an alle Empfänger gleichzeitig antworten.

Dem Absender zur Laufzeit antworten

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Antworten Sie dem Absender einer Nachricht, indem Sie einen Kommentar angeben und die Methode Reply verwenden. Eine Kopie der Nachricht wird im Ordner „Gesendete Elemente“ gespeichert.

Alternativ können Sie, wenn Sie aktualisierbare Eigenschaften für die Antwort ändern müssen, zuerst einen Entwurf einer Antwortnachricht erstellen, die Nachrichteneigenschaften aktualisieren und dann die Antwort versenden.

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/reply
Erforderliche Parameter Typ Beschreibung
URL-Parameter
message_id Zeichenfolge Die ID der Nachricht, auf die geantwortet werden soll.
Textkörper-Parameter
Kommentar Zeichenfolge Ein Kommentar, der eingefügt werden kann. Kann eine leere Zeichenfolge sein.

Beispielanfrage

POST https://outlook.office.com/api/v1.0/me/messages/AAMkAGE0Mz8DmAAA=/reply
Content-Type: application/json

{
  "Comment": "Sounds great! See you tomorrow."
}

Beispielantwort

Status code: 202

Zur Laufzeit allen antworten

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Antworten Sie allen Empfängern einer Nachricht durch Angabe eines Kommentars und Verwendung der Methode ReplyAll. Eine Kopie der Nachricht wird im Ordner „Gesendete Elemente“ gespeichert.

Alternativ können Sie, wenn Sie irgendwelche aktualisierbare Eigenschaften für die Antwort ändern müssen, zuerst einen Entwurf einer Antwortnachricht an alle erstellen, die Nachrichteneigenschaften aktualisieren und dann die Antwort versenden.

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/replyall
Erforderliche Parameter Typ Beschreibung
URL-Parameter
message_id Zeichenfolge Die ID der Nachricht, auf die geantwortet werden soll.
Textkörper-Parameter
Kommentar Zeichenfolge Ein Kommentar, der eingefügt werden kann. Kann eine leere Zeichenfolge sein.

Beispielanfrage

POST https://outlook.office.com/api/v1.0/me/messages/AAMkAGE0MSz8DmAAA=/replyall
Content-Type: application/json

{
  "Comment": "Thanks for the heads up."
}

Beispielantwort

Status code: 202

Einen Entwurf einer Antwortnachricht erstellen

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Erstellen Sie einen Antwort-Entwurf auf die angegebene Nachricht. Anschließend können Sie den Entwurf aktualisieren, um den Antwortinhalt zum Text hinzuzufügen oder andere Nachrichteneigenschaften ändern. Sie können den Entwurf auch einfach versenden.

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/createreply
Erforderliche Parameter Typ Beschreibung
URL-Parameter
message_id Zeichenfolge Die ID der Nachricht, auf die geantwortet werden soll.

Beispielanfrage

POST https://outlook.office.com/api/v1.0/me/messages/AAMkADA1MTAAAAqldOAAA=/createreply

Beispielantwort

Status code: 201

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('86b6ceaf-57f7-4278-97c4-4da0a97f6cdb@70559e59-b378-49ea-8e53-07a3a3d27f5b')/Messages('AAMkADA1MTAAAH5JKoAAA=')",
  "@odata.etag": "W/\"CQAAABYAAADX8oL1Wa7jQbcPAHouCzswAAAH5/DO\"",
  "Id": "AAMkADA1MTAAAH5JKoAAA=",
  "CreatedDateTime": "2016-03-15T08:33:43Z",
  "LastModifiedDateTime": "2016-03-15T08:33:43Z",
  "ChangeKey": "CQAAABYAAADX8oL1Wa7jQbcPAHouCzswAAAH5/DO",
  "Categories": [ ],
  "ReceivedDateTime": "2016-03-15T08:33:43Z",
  "SentDateTime": "2016-03-15T08:33:43Z",
  "HasAttachments": false,
  "InternetMessageId": "<DM2PR00MB00571796B16132601E1F286CF7890@DM2PR00MB0057.namprd00.prod.outlook.com>",
  "Subject": "RE: Let's start a group",
  "Body": {
    "ContentType": "HTML",
    "Content": "<html>\r\n<body>Fanny, would you name the group if the project is approved, please?\r\n<b>From:</b> Fanny Downs<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<p>That's a great idea!<br>\r\n</body>\r\n</html>"
  },
  "BodyPreview": "Fanny, would you name the group if the project is approved, please?\r\n________________________________\r\nFrom: Fanny Downs\r\nSent: Friday, March 4, 2016 12:23:35 AM\r\nTo: Admin\r\nSubject: Re: Let's start a group\r\n\r\n\r\nThat's a gre",
  "Importance": "Normal",
  "ParentFolderId": "AQMkADA1MTAAAAIBDwAAAA==",
  "Sender": {
    "EmailAddress": {
      "Name": "Admin",
      "Address": "admin@contoso.onmicrosoft.com"
    }
  },
  "From": null,
  "ToRecipients": [
    {
      "EmailAddress": {
        "Name": "Fanny Downs",
        "Address": "fannyd@contoso.onmicrosoft.com"
      }
    }
  ],
  "CcRecipients": [ ],
  "BccRecipients": [ ],
  "ReplyTo": [ ],
  "ConversationId": "AAQkADA1MTVGjIwpLvWmGtIo-aFE=",
  "IsDeliveryReceiptRequested": false,
  "IsReadReceiptRequested": false,
  "IsRead": true,
  "IsDraft": true,
  "WebLink": "https://outlook.office.com/owa/?ItemID=AAMkADA1MTAAAH5JKoAAA%3D&exvsurl=1&viewmodel=ReadMessageItem",
  "MentionedMe": null,
  "AppliedHashtagsPreview": null,
  "LikesPreview": null,
  "MentionsPreview": null,
  "Mentioned": [ ],
  "InferenceClassification": "Focused",
  "UnsubscribeData": [ ],
  "UnsubscribeEnabled": false,
  "Flag": { "FlagStatus": "NotFlagged" }
}

Antworttyp

Die Nachricht des Antwortentwurfs mit den Eigenschaften ToRecipient, IsDraft und anderen geeigneten Eigenschaften ist vorausgefüllt.

Einen Entwurf einer Antwortnachricht an alle erstellen

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Erstellen Sie einen Entwurf, um dem Absender und allen Empfängern der angegebenen Nachricht zu antworten. Anschließend können Sie den Entwurf aktualisieren, um den Antwortinhalt zum Text hinzuzufügen oder andere Nachrichteneigenschaften ändern. Sie können den Entwurf auch einfach versenden.

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/createreplyall
Erforderliche Parameter Typ Beschreibung
URL-Parameter
message_id Zeichenfolge Die ID der Nachricht, auf die geantwortet werden soll.

Beispielanfrage

POST https://outlook.office.com/api/v1.0/me/messages/AAMkAGE0Mz8DmAAA=/createreplyall

Beispielantwort

Status code: 201

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Messages('AAMkAGE0Mz7k5AAA=')",
  "@odata.etag": "W/\"CQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAS0AhF\"",
  "Id": "AAMkAGE0Mz7k5AAA=",
  "ChangeKey": "CQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAS0AhF",
  "Categories": [],
  "CreatedDateTime": "2014-10-18T21:21:06Z",
  "LastModifiedDateTime": "2014-10-18T21:21:06Z",
  "Subject": "RE: Check out the new Office 365 APIs",
  "BodyPreview": "If the project gets approved, please decide on the name.\r\n_________________________________\r\nFrom: Alex D\r\nSent: Saturday, October 18, 2014 9:18:18 PM\r\nTo: Katie Jordan; Garth Fort\r\nSubj",
  "Body": {
    "ContentType": "HTML",
    "Content": "<html>\r\n...</html>\r\n"
  },
  "Importance": "Normal",
  "HasAttachments": false,
  "ParentFolderId": "AAMkAGE0MAAEPAAA=",
  "From": null,
  "Sender": {
    "EmailAddress": {
      "Address": "alexd@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Alex D"
    }
  },
  "ToRecipients": [
    {
      "EmailAddress": {
        "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com",
        "Name": "Katie Jordan"
      }
    },
    {
      "EmailAddress": {
        "Address": "garthf@a830edad9050849NDA1.onmicrosoft.com",
        "Name": "Garth Fort"
      }
    }
  ],
  "CcRecipients": [],
  "BccRecipients": [],
  "ReplyTo": [],
  "ConversationId": "AAQkAGE0M3HbTkEU=",
  "ReceivedDateTime": "2014-10-18T21:21:06Z",
  "SentDateTime": "2014-10-18T21:21:06Z",
  "IsDeliveryReceiptRequested": false,
  "IsReadReceiptRequested": false,
  "IsDraft": true,
  "IsRead": true
}

Antworttyp

Die Nachricht des Antwortentwurfs mit den Eigenschaften ToRecipient, IsDraft und anderen geeigneten Eigenschaften ist vorausgefüllt.

Neue oder entworfene Nachrichten weiterleiten

Hinweis

Das Verhalten der Vorgänge in diesem Abschnitt hängt von der Version ab. Erfahren Sie mehr, indem Sie eine Version unter Office 365 REST-API-Referenz im Inhaltsverzeichnis auf der linken Seite auswählen.

Sie können eine Nachricht direkt weiterleiten oder Sie können einen Entwurf einer Weiterleitungsnachricht erstellen, aktualisieren und dann versenden.

Eine Nachricht direkt weiterleiten

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Leiten Sie eine Nachricht mit der Methode Forward weiter und geben Sie optional einen Kommentar an. Eine Kopie der Nachricht wird im Ordner „Gesendete Elemente“ gespeichert.

Alternativ, wenn Sie irgendwelche aktualisierbare Eigenschaften in der zu übermittelnden Nachricht ändern müssen, können Sie zuerst einen Entwurf einer Weiterleitungsnachricht erstellen, die Nachrichteneigenschaften aktualisieren und dann die Antwort versenden.

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/forward
Erforderliche Parameter Typ Beschreibung
URL-Parameter
message_id Zeichenfolge Die ID der Nachricht, die weitergeleitet werden soll.
Textkörper-Parameter
Kommentar Zeichenfolge Ein Kommentar, der eingefügt werden kann. Kann eine leere Zeichenfolge sein.
ToRecipients Sammlung (Empfänger) Die Liste der Empfänger.

Geben Sie die Parameter Comment und ToRecipients im Anforderungstext an.

Beispielanfrage

POST https://outlook.office.com/api/v1.0/me/messages/AAMkAGE0Mz8DmAAA=/forward
Content-Type: application/json

{
  "Comment": "FYI",
  "ToRecipients": [
    {
      "EmailAddress": {
        "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com"
      }
    },
    {
      "EmailAddress": {
        "Address": "garthf@a830edad9050849NDA1.onmicrosoft.com"
      }
    }
  ]
}

Beispielantwort

Status code: 202

Entwurf für eine Weiterleitungsnachricht erstellen

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Erstellen Sie einen Entwurf, um die angegebene Nachricht weiterzuleiten. Anschließend können Sie den Entwurf aktualisieren, um dem Text Inhalte hinzuzufügen oder andere Nachrichteneigenschaftenzu ändern. Sie können den Entwurf auch einfach senden.

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/createforward
Erforderliche Parameter Typ Beschreibung
URL-Parameter
message_id Zeichenfolge Die ID der Nachricht, die weitergeleitet werden soll.

Beispielanfrage

POST https://outlook.office.com/api/v1.0/me/messages/AAMkAGE0Mz8DmAAA=/createforward

Beispielantwort

Status code: 201

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Messages('AAMkAGE0Mz7k6AAA=')",
  "@odata.etag": "W/\"CQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAS0AhG\"",
  "Id": "AAMkAGE0Mz7k6AAA=",
  "ChangeKey": "CQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAS0AhG",
  "Categories": [],
  "CreatedDateTime": "2016-03-15T08:42:10Z",
  "LastModifiedDateTime": "2016-03-15T08:42:10Z",
  "Subject": "FW: Let's start a group",
  "BodyPreview": "Dana, just want to make sure you get this.\r\n________________________________\r\nFrom: Admin\r\nSent: Tuesday, March 15, 2016 6:47:54 AM\r\nTo: Fanny Downs; Randi Welch\r\nSubject: RE: Let's st",
  "Body": {
    "ContentType": "HTML",
    "Content": "<html>\r\n...</html>\r\n"
  },
  "Importance": "Normal",
  "HasAttachments": false,
  "ParentFolderId": "AAMkAGE0MAAEPAAA=",
  "From": null,
  "Sender": {
    "EmailAddress": {
      "Address": "'alexd@contoso.onmicrosoft.com'",
      "Name": "Alex D"
    }
  },
  "ToRecipients": [],
  "CcRecipients": [],
  "BccRecipients": [],
  "ReplyTo": [],
  "ConversationId": "AAQkAGE0M3HbTkEU=",
  "ReceivedDateTime": "2016-03-15T08:42:10Z",
  "SentDateTime": "2016-03-15T08:42:10Z",
  "IsDeliveryReceiptRequested": false,
  "IsReadReceiptRequested": false,
  "IsDraft": true,
  "IsRead": true
}

Antworttyp

Die Nachricht des Antwortentwurfs ist mit IsDraft und entsprechenden Eigenschaften vorausgefüllt.

Nachricht aktualisieren

Ändern Sie die Schreibberechtigung einer Nachricht und sichern Sie die Änderungen.

Eine Nachricht aktualisieren

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Ändern Sie beschreibbare Eigenschaften in einem Entwurf oder einer bestehenden Nachricht. Nur die Eigenschaften, die Sie angeben, werden geändert.

PATCH https://outlook.office.com/api/v1.0/me/messages/{message_id}
Erforderliche Parameter Typ Beschreibung
URL-Parameter
message_id Zeichenfolge Die ID der zu aktualisierenden Nachricht.

Geben Sie im Anforderungstext eine oder mehrere beschreibbare Nachrichten-Eigenschaften an.

Beispielanfrage

PATCH https://outlook.office.com/api/v1.0/me/messages/AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MABGAAAAAAC_0WfqSjt_SqLtNkuO-bj1BwAmP1Ln1wcHRariNdTMGAO9AAAAAAEMAAAmP1Ln1wcHRariNdTMGAO9AAASz8S-AAA=

Content-Type: application/json

{
  "Categories": [
    "Orange category",
    "Green category"
  ],
  "IsRead": true
}

Beispielantwort

Statuscode: 200

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "@odata.etag": "W/\"CQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAS0AIP\"",
  "Id": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MABGAAAAAAC_0WfqSjt_SqLtNkuO-bj1BwAmP1Ln1wcHRariNdTMGAO9AAAAAAEMAAAmP1Ln1wcHRariNdTMGAO9AAASz8S-AAA=",
  "ChangeKey": "CQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAS0AIP",
  "Categories": [
    "Orange category",
    "Green category"
  ],
  "DateTimeCreated": "2014-10-17T17:12:15Z",
  "DateTimeLastModified": "2014-10-19T03:24:35Z",
  "Subject": "Meeting notes from today",
  "BodyPreview": "See attached",
  "Body": {
    "ContentType": "HTML",
    "Content": "<html>\r\n<head>\r\n<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\r\n<style type=\"text/css\" style=\"display:none\"><!-- p { margin-top: 0px; margin-bottom: 0px; }--></style>\r\n</head>\r\n<body dir=\"ltr\">\r\n<div id=\"divtagdefaultwrapper\" style=\"color: rgb(0, 0, 0); font-family: Calibri,Arial,Helvetica,sans-serif; font-size: 12pt; background-color: rgb(255, 255, 255);\">\r\n<p>See attached</p>\r\n</div>\r\n</body>\r\n</html>\r\n"
  },
  "Importance": "Normal",
  "HasAttachments": true,
  "ParentFolderId": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAAAAAEMAAA=",
  "From": {
    "EmailAddress": {
      "Address": "alexd@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Alex D"
    }
  },
  "Sender": {
    "EmailAddress": {
      "Address": "alexd@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Alex D"
    }
  },
  "ToRecipients": [
    {
      "EmailAddress": {
        "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com",
        "Name": "Katie Jordan"
      }
    }
  ],
  "CcRecipients": [],
  "BccRecipients": [],
  "ReplyTo": [],
  "ConversationId": "AAQkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAQANKneItHNYxNlwnKip-qvhs=",
  "DateTimeReceived": "2014-10-17T17:12:15Z",
  "DateTimeSent": "2014-10-17T17:12:12Z",
  "IsDeliveryReceiptRequested": false,
  "IsReadReceiptRequested": false,
  "IsDraft": false,
  "IsRead": true
}

Antworttyp

Die aktualisierte Nachricht.

Nachrichten löschen

Hinweis

Seien Sie vorsichtig, wenn Sie Nachrichten löschen. Gelöschte Inhalte können möglicherweise nicht wiederhergestellt werden. Weitere Informationen finden Sie unter Elemente löschen.

Eine Nachricht löschen

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

DELETE https://outlook.office.com/api/v1.0/me/messages/{message_id}
Erforderliche Parameter Typ Beschreibung
URL-Parameter
message_id Zeichenfolge Die ID der zu löschenden Nachricht.

Beispielanfrage

DELETE https://outlook.office.com/api/v1.0/me/messages/AAMkAGE0Mz8TBAAA=

Beispielantwort

Status code: 204

Nachrichten verschieben oder kopieren

Sie können eine Nachricht in einen Ordner verschieben oder kopieren.

Eine Nachricht verschieben

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Verschiebt eine Nachricht in einen Ordner. Dadurch wird eine neue Kopie der Nachricht im Zielordner erstellt.

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/move
Erforderliche Parameter Typ Beschreibung
URL-Parameter
message_id Zeichenfolge Die ID der zu verschiebenden Nachricht.
Textkörper-Parameter
DestinationId Zeichenfolge Die Zielordner-ID oder der Inbox, Drafts, SentItems oder DeletedItems der bekannte Ordnername.

Beispielanfrage

POST https://outlook.office.com/api/v1.0/me/messages/AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEJAACd9nJ-tVysQos2hTfspaWRAAADTIy-AAA=/move

Content-Type: application/json

{
  "DestinationId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEJAAA="
}

Beispielantwort

Statuscode: 201

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "@odata.etag": "W/\"CQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTJqP\"",
  "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEJAACd9nJ-tVysQos2hTfspaWRAAADTshBhAAA=",
  "ChangeKey": "CQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTJqP",
  "Categories": [],
  "DateTimeCreated": "2014-10-20T00:13:21Z",
  "DateTimeLastModified": "2014-10-20T00:13:23Z",
  "Subject": "Contract Signing",
  "BodyPreview": "There will be a detailed legal review of Project Falcon once the contract is ready.",
  "Body": {
    "ContentType": "Text",
    "Content": "There will be a detailed legal review of Project Falcon once the contract is ready."
  },
  "Importance": "Normal",
  "HasAttachments": false,
  "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEJAAA=",
  "From": {
    "EmailAddress": {
      "Address": "alexd@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Alex D"
    }
  },
  "Sender": {
    "EmailAddress": {
      "Address": "alexd@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Alex D"
    }
  },
  "ToRecipients": [
    {
      "EmailAddress": {
        "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com",
        "Name": "Katie Jordan"
      }
    },
    {
      "EmailAddress": {
        "Address": "garthf@a830edad9050849NDA1.onmicrosoft.com",
        "Name": "Garth Fort"
      }
    }
  ],
  "CcRecipients": [],
  "BccRecipients": [],
  "ReplyTo": [],
  "ConversationId": "AAQkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAQAKjRc0YJSUBJpofjWgitxag=",
  "DateTimeReceived": "2014-10-20T00:13:21Z",
  "DateTimeSent": "2014-10-20T00:13:21Z",
  "IsDeliveryReceiptRequested": false,
  "IsReadReceiptRequested": false,
  "IsDraft": false,
  "IsRead": true
}

Antworttyp

Die Nachricht, die verschoben wurde.

Eine Nachricht kopieren

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Mit dieser API können Sie Nachrichten in Ordner kopieren.

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/copy
Erforderliche Parameter Typ Beschreibung
URL-Parameter
message_id Zeichenfolge Die ID der zu kopierenden Nachricht.
Textkörper-Parameter
DestinationId Zeichenfolge Die Zielordner-ID oder der Inbox, Drafts, SentItems oder DeletedItems der bekannte Ordnername.

Beispielanfrage

POST https://outlook.office.com/api/v1.0/me/messages/AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEJAACd9nJ-tVysQos2hTfspaWRAAADTIy-AAA=/copy

Content-Type: application/json

{
  "DestinationId": "inbox"
}

Beispielantwort

Statuscode: 201

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "@odata.etag": "W/\"CQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAS0AIS\"",
  "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEJAACd9nJ-tVysQos2hTfspaWRAAADT8DtAAA=",
  "ChangeKey": "CQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTJqP",
  "Categories": [],
  "DateTimeCreated": "2014-10-20T00:13:21Z",
  "DateTimeLastModified": "2014-10-20T00:13:23Z",
  "Subject": "Contract Signing",
  "BodyPreview": "There will be a detailed legal review of Project Falcon once the contract is ready.",
  "Body": {
    "ContentType": "Text",
    "Content": "There will be a detailed legal review of Project Falcon once the contract is ready."
  },
  "Importance": "Normal",
  "HasAttachments": false,
  "ParentFolderId": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAAAAAEMAAA=",
  "From": {
    "EmailAddress": {
      "Address": "alexd@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Alex D"
    }
  },
  "Sender": {
    "EmailAddress": {
      "Address": "alexd@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Alex D"
    }
  },
  "ToRecipients": [
    {
      "EmailAddress": {
        "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com",
        "Name": "Katie Jordan"
      }
    },
    {
      "EmailAddress": {
        "Address": "garthf@a830edad9050849NDA1.onmicrosoft.com",
        "Name": "Garth Fort"
      }
    }
  ],
  "CcRecipients": [],
  "BccRecipients": [],
  "ReplyTo": [],
  "ConversationId": "AAQkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAQAKjRc0YJSUBJpofjWgitxag=",
  "DateTimeReceived": "2014-10-20T00:13:21Z",
  "DateTimeSent": "2014-10-20T00:13:21Z",
  "IsDeliveryReceiptRequested": false,
  "IsReadReceiptRequested": false,
  "IsDraft": false,
  "IsRead": true
}

Antworttyp

Die neue Kopie der Nachricht.

Posteingang mit Relevanz verwalten

Dieses Feature ist derzeit in v2.0 und Beta verfügbar. Wechseln Sie im Inhaltsverzeichnis auf der linken Seite zum Abschnitt Office 365-REST-API-Referenz und wählen Sie die gewünschte Version aus.

@-Menüs verwalten (Vorschauversion)

Dieses Feature ist derzeit in der Beta-Version verfügbar. Wechseln Sie im Inhaltsverzeichnis auf der linken Seite zum Abschnitt Office 365-REST-API-Referenz und wählen Sie Beta.

Regeln verwalten (Vorschauversion)

Dieses Feature ist derzeit in der Beta-Version verfügbar. Wechseln Sie im Inhaltsverzeichnis auf der linken Seite zum Abschnitt Office 365-REST-API-Referenz und wählen Sie Beta.

Abbestellen (Vorschauversion)

Dieses Feature ist derzeit in der Beta-Version verfügbar. Wechseln Sie im Inhaltsverzeichnis auf der linken Seite zum Abschnitt Office 365-REST-API-Referenz und wählen Sie Beta.

Sprachauswahl abrufen (Vorschauversion)

Dieses Feature ist derzeit nur in der Beta-Version verfügbar. Wechseln Sie im Inhaltsverzeichnis auf der linken Seite zum Abschnitt Office 365-REST-API-Referenz und wählen Sie Beta.

Zeitzonenauswahl abrufen (Vorschauversion)

Dieses Feature ist derzeit nur in der Beta-Version verfügbar. Wechseln Sie im Inhaltsverzeichnis auf der linken Seite zum Abschnitt Office 365-REST-API-Referenz und wählen Sie Beta.

Postfacheinstellungen abrufen

Dieses Feature ist derzeit in v2.0 und Beta verfügbar. Wechseln Sie im Inhaltsverzeichnis auf der linken Seite zum Abschnitt Office 365-REST-API-Referenz und wählen Sie die gewünschte Version aus.

Automatische Antworteinstellungen abrufen

Dieses Feature ist derzeit in v2.0 und Beta verfügbar. Weitere Informationen finden Sie im Inhaltsverzeichnis auf der linken Seite im Abschnitt Office 365-REST-API-Referenz und wählen Sie eine dieser Versionen aus.

Automatische Antworteinstellungen aktualisieren

Dieses Feature ist derzeit in v2.0 und Beta verfügbar. Wechseln Sie im Inhaltsverzeichnis auf der linken Seite zum Abschnitt Office 365-REST-API-Referenz und wählen Sie die gewünschte Version aus.

E-Mail-Info abrufen (Vorschauversion)

Dieses Feature ist derzeit in der Beta-Version verfügbar. Wechseln Sie im Inhaltsverzeichnis auf der linken Seite zum Abschnitt Office 365-REST-API-Referenz und wählen Sie Beta.

Anlagen abrufen

Sie können eine Anlagensammlung oder einen Anhang abrufen. Anhänge können Dateien sein (zum Beispiel,

Eine Anlagensammlung abrufen

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Die Anhänge einer bestimmten Nachricht abrufen.

GET https://outlook.office.com/api/v1.0/me/messages/{message_id}/attachments
Erforderliche Parameter Typ Beschreibung
URL-Parameter
message_id Zeichenfolge Die Nachrichten-ID.

Hinweis

Standardmäßig enthält jede Anlage in der Antwort alle ihre Eigenschaften, die diesem Anlagentyp entsprechen. Verwenden Sie $select, um nur die Eigenschaften anzugeben, die Sie für die beste Leistung benötigen. Die ID-Eigenschaft wird immer zurückgegeben. Siehe OData Abfrage-Parameter für Filter-, Sortier- und Paging-Parameter.

Antworttyp

Eine Anlagensammlung, die vom Typ FileAttachment oder ItemAttachment sein kann.

Beispiel-Anforderungen und -Antworten

Das folgende Beispiel zeigt, wie man $select verwendet, um nur die Eigenschaft Name jeder Dateianlage in der Antwort zurückzugeben. Siehe die erste Beispielantwort in Eine Anlage abrufen für eine vollständige Liste der Eigenschaften, die für eine Anlage zurückgegeben würden, wenn Sie nicht $select verwenden.

Beispielanfrage

GET https://outlook.office.com/api/v1.0/me/messages/AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEMAACd9nJ-tVysQos2hTfspaWRAAADTHVSAAA=/attachments?$select=Name

Beispielantwort

Statuscode: 200

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages('AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEMAACd9nJ-tVysQos2hTfspaWRAAADTHVSAAA%3D')/Attachments",
  "value": [
    {
      "@odata.type": "#Microsoft.OutlookServices.FileAttachment",
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
      "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEMAACd9nJ-tVysQos2hTfspaWRAAADTHVSAAABEgAQANQEWV4bM8FIlPwxj4kShdM=",
      "Name": "minutes.docx",
      "ContentType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
      "Size": 11585,
      "IsInline": false,
      "DateTimeLastModified": "2014-10-20T00:41:52Z",
      "ContentId": null,
      "ContentLocation": null,
      "IsContactPhoto": false,
      "ContentBytes": "UEsDBBQABgAIAAAAIQDCAAA4KQAAAAA="
    }
  ]
}

Das folgende Beispiel zeigt den Abruf der einzigen Anlage, die ein Outlook-Mail-Element ist. Die Antwort enthält eine Anlagen-ID, die gleichzeitig die ID der angehängten Nachricht ist.

GET https://outlook.office.com/api/v1.0/me/messages('AAMkADFiNTPAAA=')/attachments

Content-Type: application/json

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages('AAMkADFiNTPAAA%3D')/Attachments",
  "value": [
    {
      "@odata.type": "#Microsoft.OutlookServices.ItemAttachment",
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-20075df800e5@1717622f-1d94-4d0c-9d74-f907ad6677b4')/Messages('AAMkADFiNTPAAA=')/Attachments('AAMkADFiNTAUhhYuYi0=')",
      "Id": "AAMkADFiNTAUhhYuYi0=",
      "Name": "How to retrieve item attachment using Outlook REST API",
      "ContentType": message/rfc822,
      "Size": 71094,
      "IsInline": false,
      "DateTimeLastModified": "2015-09-24T05:57:59Z",
    }
  ]
}

Eine Anlage abrufen

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Rufen Sie eine Anlage von einer bestimmten Nachricht ab.

GET https://outlook.office.com/api/v1.0/me/messages/{message_id}/attachments/{attachment_id}

Hinweis

Siehe OData Abfrage-Parameter für Filter-, Sortier- und Paging-Parameter.

Erforderliche Parameter Typ Beschreibung
URL-Parameter
message_id Zeichenfolge Die Nachrichten-ID.
attachment_id Zeichenfolge Die Anlagen-ID.

Hinweis

Standardmäßig enthält die Antwort alle Eigenschaften der Anlage. Verwenden Sie $select, um nur die Eigenschaften anzugeben, die Sie für die beste Leistung benötigen. Ein Beispiel findet sich unter Eine Anlagensammlung abrufen. Die ID-Eigenschaft wird immer zurückgegeben. Siehe OData Abfrage-Parameter für Filter-, Sortier- und Paging-Parameter.

Antworttyp

Die angeforderte Dateianlage oder Elementanlage.

Beispielanfrage

GET https://outlook.office.com/api/v1.0/me/messages/AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEMAACd9nJ-tVysQos2hTfspaWRAAADTHVSAAA=/attachments/AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEMAACd9nJ-tVysQos2hTfspaWRAAADTHVSAAABEgAQANQEWV4bM8FIlPwxj4kShdM=

Beispielantwort

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Messages('AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEMAACd9nJ-tVysQos2hTfspaWRAAADTHVSAAA%3D')/Attachments/$entity",
  "@odata.type": "#Microsoft.OutlookServices.FileAttachment",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "Id": "AAMkAGI2j4kShdM=",
  "Name": "minutes.docx",
  "ContentType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
  "Size": 11585,
  "IsInline": false,
  "DateTimeLastModified": "2014-10-20T00:41:52Z",
  "ContentId": null,
  "ContentLocation": null,
  "IsContactPhoto": false,
  "ContentBytes": "UEsDBBQABgAIAAAAIQDCAAA4KQAAAAA=",
}

Anlagen erstellen

Sie können einen Dateianhang erstellen oder für eine Nachricht eine Elementanlage erstellen.

Eine Dateianlage erstellen

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Fügen Sie einer Nachricht eine Dateianlage hinzu.

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/attachments
Erforderliche Parameter Typ Beschreibung
URL-Parameter
message_id Zeichenfolge Die Nachrichten-ID.
Textkörper-Parameter
@odata.type Zeichenfolge #Microsoft.OutlookServices.FileAttachment
Name Zeichenfolge Der Name der Anlage.
ContentBytes Binär Die Datei, die angehängt werden soll.

Geben Sie die Parameter Name und ContentBytes und alle beschreibbaren Dateianlagen-Eigenschaften im Anforderungstext an.

Antworttyp

Die neue Dateianlage.

Eine Elementanlage erstellen

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Fügen Sie einer Nachricht eine Elementanlage hinzu.

POST https://outlook.office.com/api/v1.0/me/messages/{message_id}/attachments
Erforderliche Parameter Typ Beschreibung
URL-Parameter
message_id Zeichenfolge Die Nachrichten-ID.
Textkörper-Parameter
@odata.type Zeichenfolge #Microsoft.OutlookServices.ItemAttachment
Name Zeichenfolge Der Name der Anlage.
Element Eine Nachricht oder Ereignis-Entität. Das anzufügende Element.

Geben Sie die Parameter Name und Item und alle beschreibbaren Elementanlagen-Eigenschaften im Anforderungstext an.

Antworttyp

Die neue Elementanlage.

Eine Verweisanlage erstellen

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Fügen Sie einer Nachricht eine Verweisanlage hinzu.

Dieses Feature ist derzeit nur in der Beta-Version verfügbar. Wechseln Sie im Inhaltsverzeichnis auf der linken Seite zum Abschnitt Office 365-REST-API-Referenz und wählen Sie Beta.

Anlagen löschen

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Löscht die angegebene Anlage einer Nachricht. Die Anlage kann eine Dateianlage oder Elementanlage sein.

DELETE https://outlook.office.com/api/v1.0/me/messages/{message_id}/attachments/{attachment_id}
Erforderliche Parameter Typ Beschreibung
URL-Parameter
message_id Zeichenfolge Die Nachrichten-ID.
attachment_id Zeichenfolge Die Anlagen-ID.

Beispielanfrage

DELETE https://outlook.office.com/api/v1.0/me/messages/AAMkAGE0Mz8S-AAA=/attachments/AAMkAGE0Mg67gL7o=

Beispielantwort

Status code: 204

Ordner abrufen

Sie können eine Ordner-Sammlung oder einen Ordner im Postfach des Benutzers abrufen.

Eine Ordnersammlung abrufen

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Holen Sie sich die Ordner-Sammlung unter dem Stammordner des angemeldeten Benutzers (.../me/folders) oder unter dem angegebenen Ordner. Sie können die .../me/folders-Verknüpfung zum Abrufen der Ordnersammlung auf oberster Ebene und zum Navigieren zu einem anderen Ordner verwenden.

GET https://outlook.office.com/api/v1.0/me/folders
GET https://outlook.office.com/api/v1.0/me/folders/{folder_id}/childfolders

Hinweis

Siehe OData Abfrage-Parameter für Filter-, Sortier- und Paging-Parameter.

Erforderliche Parameter Typ Beschreibung
URL-Parameter
folder_id Zeichenfolge Die Ordner-ID oder die Inbox, Drafts, SentItems, oder DeletedItems bekannter Ordnername, wenn Sie Ordner aus einem bestimmten Ordner erhalten.

Beispielanfrage

GET https://outlook.office.com/api/v1.0/me/folders

Beispielantwort

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Folders",
  "value": [
    {
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
      "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEfAAA=",
      "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEIAAA=",
      "DisplayName": "Conversation Action Settings",
      "ChildFolderCount": 0
    },
    {
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
      "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEKAAA=",
      "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEIAAA=",
      "DisplayName": "Deleted Items",
      "ChildFolderCount": 0
    },
    {
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
      "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEPAAA=",
      "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEIAAA=",
      "DisplayName": "Drafts",
      "ChildFolderCount": 0
    },
    {
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
      "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEMAAA=",
      "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEIAAA=",
      "DisplayName": "Inbox",
      "ChildFolderCount": 0
    },
    {
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
      "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEQAAA=",
      "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEIAAA=",
      "DisplayName": "Journal",
      "ChildFolderCount": 0
    },
    {
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
      "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEeAAA=",
      "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEIAAA=",
      "DisplayName": "Junk Email",
      "ChildFolderCount": 0
    },
    {
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
      "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAERAAA=",
      "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEIAAA=",
      "DisplayName": "Notes",
      "ChildFolderCount": 0
    },
    {
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
      "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAELAAA=",
      "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEIAAA=",
      "DisplayName": "Outbox",
      "ChildFolderCount": 0
    }
  ]
}

Antworttyp

Die angeforderte Ordner-Sammlung.

Einen Ordner abrufen

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Einen Ordner nach ID abrufen.

GET https://outlook.office.com/api/v1.0/me/folders/{folder_id}

Hinweis

Siehe OData Abfrage-Parameter für Filter-, Sortier- und Paging-Parameter.

Erforderliche Parameter Typ Beschreibung
URL-Parameter
folder_id Zeichenfolge Die ID des Ordners oder dieInbox, Drafts, SentItems oder DeletedItems der bekannte Ordnername.

Beispielanfrage

GET https://outlook.office.com/api/v1.0/me/folders/inbox

Beispielantwort

Statuscode: 200

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Folders/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEJAAA=",
  "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEIAAA=",
  "DisplayName": "Inbox",
  "ChildFolderCount": 0,
  "UnreadItemCount": 2,
  "TotalItemCount": 2
}

Antworttyp

Der angeforderte Ordner.

Ordnerhierarchie synchronisieren

Dieses Feature ist derzeit in v2.0 und Beta verfügbar. Wechseln Sie im Inhaltsverzeichnis auf der linken Seite zum Abschnitt Office 365-REST-API-Referenz und wählen Sie die gewünschte Version aus.

Ordner erstellen

Fügen Sie einen neuen Ordner zu einer Ordner-Sammlung hinzu.

Erstellen eines Ordners

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Erstellen Sie einen Unterordner mit dem in DisplayName angegebenen Namen. DisplayName ist die einzige beschreibbare Eigenschaft für einen Ordner.

POST https://outlook.office.com/api/v1.0/me/folders/{folder_id}/childfolders
Erforderliche Parameter Typ Beschreibung
URL-Parameter
folder_id Zeichenfolge Die ID des Ordners oder dieInbox, Drafts, SentItems oder DeletedItems der bekannte Ordnername.
Textkörper-Parameter
Anzeigename Zeichenfolge Der Anzeigename des Ordners.

Beispielanfrage

POST https://outlook.office.com/api/v1.0/me/folders/inbox/childfolders

Content-Type: application/json

{
  "DisplayName": "Company"
}

Beispielantwort

Statuscode: 201

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Folders('inbox')/ChildFolders/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "Id": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAASz-l_AAA=",
  "ParentFolderId": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAAAAAEMAAA=",
  "DisplayName": "Company",
  "ChildFolderCount": 0,
  "UnreadItemCount": 2,
  "TotalItemCount": 27
}

Antworttyp

Der neue Ordner.

Bemerkungen

Sie können keinen übergeordneten Ordner erstellen. Sie können nur einen Ordner zu einem childfolders Endpunkt hinzufügen.

Ordner aktualisieren

Einen Ordnernamen ändern.

Aktualisieren eines Ordners

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Ändern Sie den Ordnernamen auf den in DisplayNameangegebenen Namen. Der Name ist die einzige beschreibbare Eigenschaft für einen Ordner.

PATCH https://outlook.office.com/api/v1.0/me/folders/{folder_id}
Erforderliche Parameter Typ Beschreibung
URL-Parameter
folder_id Zeichenfolge Die ID des Ordners oder dieInbox, Drafts, SentItems oder DeletedItems der bekannte Ordnername.
Textkörper-Parameter
Anzeigename Zeichenfolge Der neue Anzeigename des Ordners.

Beispielanfrage

PATCH https://outlook.office.com/api/v1.0/me/folders/AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAASz-l_AAA=

Content-Type: application/json

{
  "DisplayName": "Business"
}

Beispielantwort

Statuscode: 200

}
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Folders/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "Id": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAASz-l_AAA=",
  "ParentFolderId": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAAAAAEMAAA=",
  "DisplayName": "Business",
  "ChildFolderCount": 0,
  "UnreadItemCount": 4,
  "TotalItemCount": 38
}

Antworttyp

Der aktualisierte Ordner.

Ordner löschen

Einen Ordner und seinen gesamten Inhalt löschen.

Hinweis

Seien Sie vorsichtig, wenn Sie Ordner löschen. Gelöschte Inhalte können möglicherweise nicht wiederhergestellt werden. Weitere Informationen finden Sie unter Elemente löschen.

Löschen eines Ordners

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Löschen Sie den in folder_id angegebenen Ordner.

DELETE https://outlook.office.com/api/v1.0/me/folders/{folder_id}
Erforderliche Parameter Typ Beschreibung
URL-Parameter
folder_id Zeichenfolge Die ID des Ordners oder dieInbox, Drafts, SentItems oder DeletedItems der bekannte Ordnername.

Beispielanfrage

DELETE https://outlook.office.com/api/v1.0/me/MailFolders/AAMkAGE0Mz-l_AAA=

Beispielantwort

Status code: 204

Ordner verschieben oder kopieren

Sie können einen Ordner in einen anderen Ordner verschieben oder kopieren.

Einen Ordner verschieben

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Verschieben Sie einen Ordner und seinen Inhalt in einen anderen Ordner mit der Methode Move.

POST https://outlook.office.com/api/v1.0/me/folders/{folder_id}/move
Erforderliche Parameter Typ Beschreibung
URL-Parameter
folder_id Zeichenfolge Die ID des Ordners oder dieInbox, Drafts, SentItems oder DeletedItems der bekannte Ordnername.
Textkörper-Parameter
DestinationId Zeichenfolge Die Zielordner-ID oder der Inbox, Drafts, SentItems oder DeletedItems der bekannte Ordnername.

Beispielanfrage

POST https://outlook.office.com/api/v1.0/me/folders/AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAASz-l_AAA=/move

Content-Type: application/json

{
  "DestinationId": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAAOyxQ9AAA="
}

Beispielantwort

Statuscode: 201

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Folders/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "Id": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAASz-l_AAA=",
  "ParentFolderId": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAAOyxQ9AAA=",
  "DisplayName": "Business",
  "ChildFolderCount": 0,
  "UnreadItemCount": 4,
  "TotalItemCount": 38
}

Antworttyp

Der Ordner, der verschoben wurde.

Einen Ordner kopieren

Erforderlicher Mindestbereich

Eine der folgenden Varianten:

Kopieren Sie einen Ordner und seinen Inhalt in einen anderen Ordner mit der Methode Copy.

POST https://outlook.office.com/api/v1.0/me/folders/{folder_id}/copy
Erforderliche Parameter Typ Beschreibung
URL-Parameter
folder_id Zeichenfolge Die ID des Ordners oder dieInbox, Drafts, SentItems oder DeletedItems der bekannte Ordnername.
Textkörper-Parameter
DestinationId Zeichenfolge Die Zielordner-ID oder der Inbox, Drafts, SentItems oder DeletedItems der bekannte Ordnername.

Beispielanfrage

POST https://outlook.office.com/api/v1.0/me/folders/AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAASz-l_AAA=/copy

Content-Type: application/json

{
  "DestinationId": "inbox"
}

Beispielantwort

Statuscode: 201

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Folders/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "Id": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAASz-mAAAA=",
  "ParentFolderId": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAAAAAEMAAA=",
  "DisplayName": "Business",
  "ChildFolderCount": 0,
  "UnreadItemCount": 4,
  "TotalItemCount": 38
}

Antworttyp

Die neue Kopie des Ordners.

Nächste Schritte

Egal, ob Sie bereit sind, eine App zu erstellen oder einfach nur mehr darüber erfahren möchten, wir haben alles im Griff.

Oder erfahren Sie mehr über die Verwendung der Office 365-Plattform: