Automatisieren des Erstellens, Sendens und Verarbeitens von NachrichtenAutomate creating, sending, and processing messages

E-Mails werden in Microsoft Graph durch die message-Ressource dargestellt.Emails are represented by the message resource in Microsoft Graph.

Standardmäßig werden Nachrichten durch eine eindeutige Eintrags-ID in der id-Eigenschaft identifiziert.By default, messages are identified by a unique entry ID in the id property. Der Speicheranbieter weist der Nachricht eine Eintrags-ID zu, wenn die Nachricht zuerst als Entwurf gespeichert oder gesendet wurde.When a message is initially created and saved as a draft or sent, the store provider assigns the message an entry ID. Diese ID ändert sich standardmäßig, wenn die Nachricht kopiert oder in einen anderen Ordner, einen Store oder eine PST-Datei verschoben wird.By default, that ID changes when the message is copied or moved to another folder, store, or .PST file. Auf die Nachricht wird anhand ihrer aktuellen ID für die weitere Verarbeitung verwiesen.You reference the message by its current ID for further processing.

Erstellen und Senden von NachrichtenCreating and sending mail

In Outlook können Sie eine E-Mail in derselben SendMail-Aktion erstellen und senden, oder Sie können einen Entwurf erstellen, anschließend Inhalt hinzufügen und den Entwurf dann senden.In Outlook, you can create and send an email in the same sendMail action, or you can create a draft, subsequently add content and send the draft.

Wenn Sie auf eine E-Mail antworten, können Sie auf ähnliche Weise die Antwort in derselben Aktion erstellen und senden (reply, reply-all oder forward).Similarly, when responding to an email, you can create and send the response in the same action (reply, reply-all, or forward). Sie können auch einen Entwurf für die Antwort erstellen (reply, reply-all oder forward), Inhalt hinzufügen und den Entwurf zu einem späteren Zeitpunkt senden.Or, you can create a draft for the response (reply, reply-all, or forward), add content, and then send the draft at a later time.

Um programmgesteuert zwischen einem Entwurf und einer gesendeten Nachricht zu unterscheiden, überprüfen Sie die Eigenschaft isDraft.To distinguish between a draft and a sent message programmatically, check the isDraft property.

Standardmäßig werden Nachrichtenentwürfe im Ordner Draftsgespeichert, und gesendete Nachrichten werden im Ordner Sent Items gespeichert.By default, draft messages are saved in the Drafts folder, sent messages are saved in the Sent Items folder. Sie können den Ordner für Entwürfe und den Ordner für gesendete Elemente auch einfach anhand ihrer bekannten Ordnernamen erkennen.For convenience, you can identify the Drafts folder and SentItems folder by their corresponding well-known folder names.

Festlegen der from- und sender-EigenschaftenSetting the from and sender properties

Wenn in Outlook eine Nachricht erstellt wird legt Outlook in den meisten Fällen denselben angemeldeten Benutzer für die Eigenschaften from und sender fest.When a message is being composed, in most cases, Outlook sets the from and sender properties to the same signed-in user. Sie können diese Eigenschaften in den folgenden Szenarien aktualisieren:You can update these properties in the following scenarios:

  • Die from-Eigenschaft kann geändert werden, wenn der Exchange-Administrator sendAs-Rechte des Postfachs anderen Benutzern zugewiesen hat. Der Administrator kann dies tun, indem er Postfachberechtigungen des Postfachbesitzers im Azure-Portal auswählt oder das Exchange Admin Center oder ein Windows PowerShell Add-ADPermission-Cmdlet verwendet. Dann können Sie programmgesteuert die from-Eigenschaft eines dieser Benutzer festlegen, die sendAs-Rechte für das Postfach haben.The from property can be changed if the Exchange administrator has assigned sendAs rights of the mailbox to some other users. The administrator can do this by selecting Mailbox Permissions of the mailbox owner in the Azure portal, or by using the Exchange Admin Center or a Windows PowerShell Add-ADPermission cmdlet. Then, you can programmatically set the from property to one of these users who have sendAs rights for that mailbox.
  • Die sender-Eigenschaft kann geändert werden, wenn der Postfachbesitzer das Recht, Nachrichten von diesem Postfach aus zu senden, an einen oder mehrere Benutzer delegiert hat.The sender property can be changed if the mailbox owner has delegated one or more users to be able to send messages from that mailbox. Der Postfachbesitzer kann in Outlook an einen Stellvertreter delegieren.The mailbox owner can delegate in Outlook. Wenn ein Stellvertreter eine Nachricht im Namen des Postfachbesitzers sendet, legt Outlook die sender-Eigenschaft auf das Konto des Stellvertreters fest, während die from-Eigenschaft weiterhin den Postfachbesitzer angibt.When a delegate sends a message on behalf of the mailbox owner, Outlook sets the sender property to the delegate’s account, and the from property remains as the mailbox owner. Programmgesteuert können Sie die sender-Eigenschaft auf einen Benutzer festlegen, der Stellvertretungsberechtigungen für dieses Postfach besitzt.Programmatically, you can set the sender property to a user who has got delegate permissions for that mailbox.

Verwenden von MailTips zum Überprüfen des Empfängerstatus und Sparen von Zeit (Vorschau)Using MailTips to check recipient status and save time (preview)

Mit MailTips können Sie intelligente Entscheidungen treffen, bevor Sie eine E-Mail senden.Use MailTips to make smart decisions before sending an email. MailTips stellt Ihnen Informationen bereit, wie z. B. darüber, ob das Postfach eines Empfängers auf bestimmte Absender beschränkt ist oder ob zum Senden von E-Mails an den Empfänger eine Genehmigung erforderlich ist.MailTips can tell you information such as the recipient's mailbox is restricted to specific senders, or approval is required for emailing the recipient.

Lesen von Nachrichten mit Kontrolle über das zurückgegebene TextformatReading messages with control over the body format returned

Sie können eine Nachricht in einem Postfach lesen, indem Sie auf ihre ID verweisen:You can read a message in a mailbox by referencing its ID:

GET /me/messages/AAMkADhMGAAA=

Oder Sie können die Nachrichten in einem bestimmten Ordner abrufen. Gehen Sie beispielsweise folgendermaßen vor, um Nachrichten im Ordner „Entwürfe“ des angemeldeten Benutzers zu lesen:For example, to read messages in the signed-in user's Drafts folder:

GET /me/mailfolders('Drafts')

Der Nachrichtentext einer Outlook-Nachricht kann entweder das HTML- oder Textformat aufweisen, wobei HTML der standardmäßige Nachrichtentexttyp ist, der bei einer GET-Antwort zurückgegeben wird.The body of an Outlook message can be either HTML or text, with HTML as the default message body type returned in a GET response.

Wenn Sie eine Nachricht abrufen, können Sie den folgenden Anforderungsheader angeben, um die Eigenschaften body and uniqueBody im Textformat zurückzugeben:When getting a message, you can specify the following request header to return the body and uniqueBody properties in text format:

Prefer: outlook.body-content-type="text"

Sie können den folgenden Header angeben oder ihn einfach überspringen, um den Nachrichtentext im HTML-Format zu erhalten:You can specify the following header, or, just skip the header, to get the message body in HTML format:

Prefer: outlook.body-content-type="html"

Wenn Sie einen der Header angeben, enthält eine erfolgreiche Antwort den entsprechenden Preference-Applied-Header:When you specify either header, a successful response would include the corresponding Preference-Applied header:

  • Für Textformatanforderungen: Preference-Applied: outlook.body-content-type="text"For text format requests: Preference-Applied: outlook.body-content-type="text"
  • Für HTML-Formatanforderungen: Preference-Applied: outlook.body-content-type="html"For HTML format requests: Preference-Applied: outlook.body-content-type="html"

Wenn der Textkörper im HTML-Format vorliegt, entfernt Outlook 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.If the body is HTML, by default, Outlook removes any potentially unsafe HTML (for example, JavaScript) embedded in the body property before returning the body content in a REST response.

Um den gesamten ursprünglichen HTML-Inhalt abzurufen, schließen Sie den folgenden HTTP-Anforderungsheader ein:To get the entire, original HTML content, include the following HTTP request header:

Prefer: outlook.allow-unsafe-html

Integration mit der Geste „@“ aus sozialen Netzwerken (Vorschau)Integrating with '@' social gesture (preview)

@-Erwähnungen sind Benachrichtigungen, um Benutzer darauf hinzuweisen, dass sie in Nachrichten erwähnt werden.@-mentions are notifications to alert users if they are mentioned in messages. Mit der mention-Ressource können Apps die aus sozialen Netzwerken bekannte Geste, das Präfix „@“, in E-Mails festlegen und daraus abrufen.The mention resource enables apps to set and get the common online social gesture, the '@' prefix, in emails. Sie können:You can:

Sonstige gemeinsam genutzte FunktionenOther shared capabilities

Nutzen Sie die Vorteile der folgenden gemeinsamen Funktionen, die von allen Entitäten in Microsoft Graph verwendet werden:Take advantage of the following common capabilities that are shared among Microsoft Graph entities:

Nächste SchritteNext steps

Weitere Informationen:Find out more about: