Verwenden der Outlook-Mail-REST-APIUse the Outlook mail REST API

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 Berechtigungen oder Anwendungsberechtigungen kann die App auf die E-Mail-Daten des angemeldeten Benutzers oder eines beliebigen Benutzers in einem Mandanten zugreifen. Die E-Mail-Daten können sich in der Cloud in Exchange Online als Teil von Office 365 oder in einer lokalen Exchange-Installation in einer Hybridbereitstellung befinden.Microsoft Graph lets your app get authorized access to a user's Outlook mail data in a personal or organization account. With the appropriate delegated or application permissions, your app can access the mail data of the signed-in user or any user in a tenant. The mail data can be in the cloud on Exchange Online as part of Office 365, or on Exchange on-premises in a hybrid deployment.

Verwenden der E-Mail-REST-APIUsing the 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.Mail API requests are performed on behalf of a user which can be identified by the user's id property (a unique GUID), email address, or the me shortcut alias for the signed-in user.

E-Mail-Nachrichten werden durch die Ressource message dargestellt und in einem mailFolder organisiert. Nachrichten und E-Mail-Ordner werden durch ihre Eigenschaft ID identifiziert, die mit GET-Operationen abgerufen werden kann.Email messages are represented by the message resource and organized in a mailFolder. Messages and mail folders are identified by their id property, obtainable from GET operations.

Hinweis: Gehen Sie im Allgemeinen nicht davon aus, dass die IDs von message und mailfolder in einem Postfach eindeutig und unveränderlich sind. Sie können sich nach bestimmten Aktionen wie z. B. Kopieren, Verschieben oder Senden ändern.Note: In general, do not assume that message and mailfolder IDs are unique and immutable within a mailbox. They might change after certain actions such as copy, move, or send.

Nachrichtentext kann im HTML- oder Textformat vorliegen.Message bodies can be in HTML or text format.

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.You can use well-known folder names such as Inbox, Drafts, SentItems, or DeletedItems to identify certain mail folders that exist by default for all users. Eine Liste der unterstützten bekannten Ordnernamen finden Sie unter mailFolder-Ressourcentyp.For a list of supported well-known folder names, see mailFolder resource type.

Sie können z. B. Nachrichten im Outlook-Ordner Gesendete Elemente des angemeldeten Benutzers abrufen, ohne zuerst die Ordner-ID abzurufen:For example, you can get messages in the Outlook Sent Items folder of the signed-in user, without first getting the folder ID:

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

Allgemeine AnwendungsfälleCommon use cases

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.The message resource exposes properties such as categories, conversationId, flag, and importance that correspond to features available in the UI, allowing apps to automate or integrate with the built-in Outlook user experience.

Die Microsoft Graph-API stellt zudem Methoden und Aktionen bereit, die allgemeine Anwendungsfälle von Nachrichten unterstützen.The Microsoft Graph API also provides methods and actions that support common use cases of messages.

AnwendungsfälleUse cases REST-RessourcenREST resources Siehe auchSee also
Benutzerorientierte AktionenUser-centric actions
Nachrichten entwerfen, lesen, beantworten, weiterleiten, senden, aktualisieren oder löschenDraft, read, reply, forward, send, update, or delete messages messagemessage Methoden von „message“Methods of message
Das Versenden von Nachrichten im Auftrag des Postfachbesitzers an einen anderen Benutzer delegierenDelegate another user to send messages on behalf of the mailbox owner messagemessage Festlegen der Eigenschaften from und sender in einer NachrichtSetting the from and sender properties in a message
Wichtigere Nachrichten zuerst anzeigenLet user view more important messages first inferenceClassificationOverrideinferenceClassificationOverride Posteingang mit FokusFocused Inbox
Abfragen von Nachrichten und Abrufen der Nachrichten in einem SuchordnerQuery for messages and get them in a search folder mailSearchFolderAdded mailSearchFolder. Methoden von mailSearchFolderMethods of mailSearchFolder
Anlagen einer Nachricht hinzufügen, abrufen oder löschenAdd, get, or delete attachments of a message attachment,attachment,
fileAttachment,fileAttachment,
itemAttachment,itemAttachment,
referenceAttachment,referenceAttachment,
messagemessage
Methoden von „attachment“Methods of attachment
Automatische Antwort, Gebietsschema, Zeitzone oder Arbeitszeiten eines Benutzers abrufen oder aktualisierenGet or update a user's automatic reply, locale, time zone, or working hours mailboxSettings,mailboxSettings,
automaticRepliesSetting,automaticRepliesSetting,
localeInfo,localeInfo,
workingHoursworkingHours
Postfacheinstellungen des Benutzers abrufenGet user's mailbox settings,
Postfacheinstellungen des Benutzers aktualisierenUpdate user's mailbox settings
E-Mail-Infos über andere besondere Zustände eines Empfängers abrufen, wie z. B. Out-of-OfficeGet MailTips of other recipients' special status, such as out-of-office user,user,
mailTipsmailTips
MailTips abrufenGet MailTips
E-Mail- und OrdnerverwaltungMail and folder management
Nachrichten in einer E-Mail-Ordnerhierarchie organisierenOrganize messages in a mail folder hierarchy mailFoldermailFolder Methoden von „mailFolder“Methods of mailFolder
Nachrichten suchen und filternSearch and filter messages messagemessage AbfrageparameterQuery parameters
Benachrichtigung über Änderungen an Nachrichten in einem Ordner erhaltenGet notified of changes to messages in a folder subscriptionsubscription Arbeiten mit Webhooks in Microsoft GraphWorking with webhooks in Microsoft Graph
Nachrichten oder eine E-Mail-Ordnerhierarchie synchronisierenSynchronize messages or mail folder hierarchy messagemessage Inkrementelle Änderungen an Nachrichten in einem Ordner abrufenGet incremental changes to messages in a folder
App-EntwicklungApp development
Benutzerdefinierte App-Daten als Internetkopfzeilen einer Nachricht hinzufügenAdd custom app data as Internet message headers of a message meldungmessage Fügen Sie benutzerdefinierte Daten zur InternetMessageHeaders-Eigenschaft der Nachricht hinzu.Add custom data to the internetMessageHeaders property of the message.
Benutzerdefinierte App-Daten mithilfe von Erweiterungen zu einer Nachricht hinzufügenAdd custom app data to a message by using extensions openTypeExtension,openTypeExtension,
schemaExtensionschemaExtension
Hinzufügen von benutzerdefinierten Daten zu Ressourcen mithilfe von ErweiterungenAdd custom data to resources using extensions
Auf benutzerdefinierte Daten für nicht ausreichend verfügbare Outlook-MAPI-Eigenschaften zugreifenAccess custom data for under-exposed Outlook MAPI properties singleValueLegacyExtendedProperty,singleValueLegacyExtendedProperty,
multiValueLegacyExtendedPropertymultiValueLegacyExtendedProperty
Übersicht über erweiterte Outlook-EigenschaftenOutlook extended properties overview

Nächste SchritteNext steps

Die E-Mail-API kann Ihnen neue Möglichkeiten für die Interaktion mit Benutzern eröffnen:The mail API can open up new ways for you to engage with users:

Benötigen Sie weitere Ideen? Dann sehen Sie sich an, wie unsere Partner Microsoft Graph verwenden.Need more ideas? See how some of our partners are using Microsoft Graph.