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

Die Microsoft Graph-API unterstützt den Zugriff auf Daten in primären und freigegebenen Postfächern der Benutzer.The Microsoft Graph API supports accessing data in users' primary mailboxes and in shared mailboxes. Bei den Daten kann es sich um Kalender, E-Mail oder persönliche Kontakte handeln, die sich in einem Postfach in der Cloud in Exchange Online als Teil von Office 365 oder in einer lokalen Exchange-Installation in einer Hybridbereitstellung befinden.The data can be calendar, mail, or personal contacts stored in a mailbox in the cloud on Exchange Online as part of Office 365, or on Exchange on-premises in a hybrid deployment.

Die API unterstützt nicht den Zugriff auf In-Situ-Archivpostfächer, die sich weder in Exchange Online noch auf Exchange Server befinden.The API does not support accessing in-place archive mailboxes, not on Exchange Online nor on Exchange Server.

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.

Wichtig

Sie können nicht generell davon ausgehen, dass die IDs von message und mailfolder eindeutig sind und in einem Postfach immer gleich bleiben.In general, do not assume that message and mailfolder IDs are unique and always remain the same within a mailbox. Sie können sich nach bestimmten Aktionen wie z. B. Kopieren oder Verschieben ändern.They might change after certain actions such as copy or move. 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.You can choose to use immutable IDs to retain the same ID as long as the message remains in the same mailbox, with the exception of sending a draft message, and a few other scenarios. Weitere Informationen finden Sie unter Lebensdauer unveränderlicher IDs.See lifetime of immutable IDs for details.

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 mailSearchFoldermailSearchFolder Methoden von mailSearchFolderMethods of mailSearchFolder
Abrufen des MIME-Inhalts einer Nachricht oder Anlage zur NachrichtGet the MIME content of a message or message attachment messagemessage MIME-Inhalt abrufenGet MIME content
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
Sprach- und Zeitzonenauswahl für einen Benutzer abrufenGet language and time zone choices for a user localeInfo,localeInfo,
timeZoneInformationtimeZoneInformation
supportedLanguages,supportedLanguages,
supportedTimeZonessupportedTimeZones
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
Kategorisieren von NachrichtenCategorize messages outlookCategoryoutlookCategory Methoden von outlookCategoryMethods of outlookCategory
Verwenden von Posteingangsregeln zum Automatisieren von Aktionen, wie z. B. Weiterleiten bestimmter eingehender NachrichtenUse Inbox rules to automate actions such as forwarding specific incoming messages messageRulemessageRule Methoden von „messageRule“Methods of messageRule
Internetkopfzeilen einer Nachricht erhaltenGet Internet message headers of a message meldungmessage Abrufen der internetMessageHeaders-Eigenschaft einer Nachricht.Get the internetMessageHeaders property of a message.
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.