Verwenden der Outlook-Mail-REST-API

  • Artikel

Mit Microsoft Graph kann Ihre App autorisierten Zugriff auf die E-Mail-Daten eines Benutzers in einem persönlichen oder Organisationskonto in Outlook erhalten. Mit den entsprechenden delegierten Oder Anwendungs-E-Mail-Berechtigungen kann Ihre App auf die E-Mail-Daten des angemeldeten Benutzers oder eines beliebigen Benutzers in einem Mandanten zugreifen. Weitere Informationen zu Zugriffstoken, App-Registrierung und delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Grundlagen zu Authentifizierung und Autorisierung.

Die Microsoft Graph-API unterstützt den Zugriff auf Daten in primären und freigegebenen Postfächern der Benutzer. Bei den Daten kann es sich um Kalender-, E-Mail- oder persönliche Kontakte handeln, die in einem Postfach in der Cloud auf Exchange Online als Teil von Microsoft 365 oder auf Exchange lokal in einer hybriden Bereitstellung gespeichert sind.

Die API unterstützt nicht den Zugriff auf In-Situ-Archivpostfächer, die sich weder in Exchange Online noch auf Exchange Server befinden.

Verwenden der E-Mail-REST-API

E-Mail-API-Anforderungen werden im Auftrag eines Benutzers ausgeführt, der durch die Eigenschaft ID des Benutzers (eine eindeutige GUID), die E-Mail-Adresse oder die Aliasverknüpfung me für den angemeldeten Benutzer identifiziert werden kann.

Email Nachrichten werden durch die Nachrichtenressource dargestellt und in einem mailFolder organisiert. Nachrichten und E-Mail-Ordner werden durch ihre id-Eigenschaft identifiziert, die von Vorgängen abgerufen werden GET kann.

Wichtig

Sie können nicht generell davon ausgehen, dass die IDs von message und mailfolder eindeutig sind und in einem Postfach immer gleich bleiben. Sie können sich nach bestimmten Aktionen wie z. B. Kopieren oder Verschieben ändern. Um die gleiche ID beizubehalten, solange die Nachricht im selben Postfach verbleibt, außer beim Senden einer Entwurfsnachricht und in einigen anderen Szenarien, können Sie festlegen, dass unveränderliche IDs verwendet werden sollen. Weitere Informationen finden Sie unter Lebensdauer unveränderlicher IDs.

Nachrichtentext kann im HTML- oder Textformat vorliegen.

Sie können bekannte Ordnernamen wie Inbox, Drafts, SentItems oder DeletedItems verwenden, um bestimmte E-Mail-Ordner zu identifizieren, die standardmäßig für alle Benutzer vorhanden sind. Eine Liste der unterstützten bekannten Ordnernamen finden Sie unter mailFolder-Ressourcentyp.

Sie können z. B. Nachrichten im Outlook-Ordner Gesendete Elemente des angemeldeten Benutzers abrufen, ohne zuerst die Ordner-ID abzurufen:

GET /me/mailFolders('SentItems')/messages?$select=sender,subject

Allgemeine Anwendungsfälle

Die Ressource message macht Eigenschaften wie categories, conversationId, flag und importance verfügbar, die Features in der Benutzeroberfläche entsprechen, sodass Apps die integrierte Outlook-Benutzeroberfläche automatisieren oder integrieren können.

Die Microsoft Graph-API stellt zudem Methoden und Aktionen bereit, die allgemeine Anwendungsfälle von Nachrichten unterstützen.

Anwendungsfälle REST-Ressourcen Siehe auch
Benutzerorientierte Aktionen
Nachrichten entwerfen, lesen, beantworten, weiterleiten, senden, aktualisieren oder löschen message Methoden von „message“
Das Versenden von Nachrichten im Auftrag des Postfachbesitzers an einen anderen Benutzer delegieren message Festlegen der Eigenschaften from und sender in einer Nachricht
Wichtigere Nachrichten zuerst anzeigen inferenceClassificationOverride Posteingang mit Fokus
Abfragen von Nachrichten und Abrufen der Nachrichten in einem Suchordner mailSearchFolder Methoden von mailSearchFolder
Abrufen des MIME-Inhalts einer Nachricht oder Anlage zur Nachricht message MIME-Inhalt abrufen
Nachrichten mit MIME-Inhalten senden message Senden von MIME-Inhalten
Anlagen einer Nachricht hinzufügen, abrufen oder löschen attachment,
fileAttachment,
itemAttachment,
referenceAttachment,
message		 Methoden von „attachment“
Sprach- und Zeitzonenauswahl für einen Benutzer abrufen localeInfo,
timeZoneInformation		 supportedLanguages,
supportedTimeZones
Automatische Antwort, Gebietsschema, Zeitzone oder Arbeitszeiten eines Benutzers abrufen oder aktualisieren mailboxSettings,
automaticRepliesSetting,
localeInfo,
workingHours		 Postfacheinstellungen des Benutzers abrufen
Postfacheinstellungen des Benutzers aktualisieren
E-Mail-Infos über andere besondere Zustände eines Empfängers abrufen, wie z. B. Out-of-Office user,
mailTips		 MailTips abrufen
E-Mail- und Ordnerverwaltung
Nachrichten in einer E-Mail-Ordnerhierarchie organisieren mailFolder Methoden von „mailFolder“
Kategorisieren von Nachrichten outlookCategory Methoden von outlookCategory
Verwenden von Posteingangsregeln zum Automatisieren von Aktionen, wie z. B. Weiterleiten bestimmter eingehender Nachrichten messageRule Methoden von „messageRule“
Internetkopfzeilen einer Nachricht erhalten meldung Abrufen der internetMessageHeaders-Eigenschaft einer Nachricht.
Nachrichten suchen und filtern message Abfrageparameter
Benachrichtigung über Änderungen an Nachrichten in einem Ordner erhalten subscription Arbeiten mit Webhooks in Microsoft Graph
Nachrichten oder eine E-Mail-Ordnerhierarchie synchronisieren message Inkrementelle Änderungen an Nachrichten in einem Ordner abrufen
App-Entwicklung
Benutzerdefinierte App-Daten als Internetkopfzeilen einer Nachricht hinzufügen meldung Fügen Sie benutzerdefinierte Daten zur InternetMessageHeaders-Eigenschaft der Nachricht hinzu.
Benutzerdefinierte App-Daten mithilfe von Erweiterungen zu einer Nachricht hinzufügen openTypeExtension,
schemaExtension		 Hinzufügen von benutzerdefinierten Daten zu Ressourcen mithilfe von Erweiterungen
Auf benutzerdefinierte Daten für nicht ausreichend verfügbare Outlook-MAPI-Eigenschaften zugreifen singleValueLegacyExtendedProperty,
multiValueLegacyExtendedProperty		 Übersicht über erweiterte Outlook-Eigenschaften

Nächste Schritte

Die E-Mail-API kann Ihnen neue Möglichkeiten für die Interaktion mit Benutzern eröffnen: