Automatisieren des Erstellens, Sendens und Verarbeitens von Nachrichten

  • Artikel

E-Mails werden in Microsoft Graph durch die message-Ressource dargestellt.

Standardmäßig werden Nachrichten durch eine eindeutige Eintrags-ID in der id-Eigenschaft identifiziert. Der Speicheranbieter weist der Nachricht eine Eintrags-ID zu, wenn die Nachricht zuerst als Entwurf gespeichert oder gesendet wurde. Diese ID ändert sich standardmäßig, wenn die Nachricht kopiert oder in einen anderen Ordner, einen Store oder eine PST-Datei verschoben wird. Auf die Nachricht wird anhand ihrer aktuellen ID für die weitere Verarbeitung verwiesen.

Erstellen und Senden von E-Mails

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.

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

Um programmgesteuert zwischen einem Entwurf und einer gesendeten Nachricht zu unterscheiden, überprüfen Sie die Eigenschaft isDraft.

Standardmäßig werden Nachrichtenentwürfe im Ordner Draftsgespeichert, und gesendete Nachrichten werden im Ordner Sent Items gespeichert. Sie können den Ordner für Entwürfe und den Ordner für gesendete Elemente auch einfach anhand ihrer bekannten Ordnernamen erkennen.

Die Absender und Absendereigenschaften festlegen

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. Sie können diese Eigenschaften in den folgenden Szenarien aktualisieren:

  • Die from-Eigenschaft kann geändert werden, wenn der Exchange-Administrator einigen anderen Benutzern sendAs-Rechte für das Postfach zugewiesen hat. Der Administrator kann dazu postfachberechtigungen des Postfachbesitzers im Azure-Portal auswählen oder das Exchange Admin Center oder ein Windows PowerShell Add-ADPermission-Cmdlet verwenden. Anschließend können Sie die from-Eigenschaft programmgesteuert auf einen dieser Benutzer festlegen, die über sendAs-Rechte für dieses Postfach verfügen.
  • 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. Der Postfachbesitzer kann in Outlook an einen Stellvertreter delegieren. 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. Programmgesteuert können Sie die sender-Eigenschaft auf einen Benutzer festlegen, der Stellvertretungsberechtigungen für dieses Postfach besitzt.

E-Mail-Infos verwenden, um den Empfängerstatus zu überprüfen und Zeit zu sparen (Vorschau)

Mit MailTips können Sie intelligente Entscheidungen treffen, bevor Sie eine E-Mail senden. 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.

Nachrichten mit Kontrolle über das zurückgegebene Textformat lesen

Sie können eine Nachricht in einem Postfach lesen, indem Sie auf ihre ID verweisen:

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:

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.

Wenn Sie eine Nachricht abrufen, können Sie den folgenden Anforderungsheader angeben, um die Eigenschaften body and uniqueBody im Textformat zurückzugeben:

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:

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

Wenn Sie einen der Header angeben, enthält eine erfolgreiche Antwort den entsprechenden Preference-Applied-Header:

  • Für Textformatanforderungen: Preference-Applied: outlook.body-content-type="text"
  • Für HTML-Formatanforderungen: 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.

Um den gesamten ursprünglichen HTML-Inhalt abzurufen, schließen Sie den folgenden HTTP-Anforderungsheader ein:

Prefer: outlook.allow-unsafe-html

Mit sozialer Geste ‚@‘ integrieren (Vorschau)

@-Erwähnungen sind Benachrichtigungen, um Benutzer darauf hinzuweisen, dass sie in Nachrichten erwähnt werden. Mit der mention-Ressource können Apps die aus sozialen Netzwerken bekannte Geste, das Präfix „@“, in E-Mails festlegen und daraus abrufen. Sie können:

Sonstige gemeinsam genutzte Funktionen

Nutzen Sie die Vorteile der folgenden gemeinsamen Funktionen, die von allen Entitäten in Microsoft Graph verwendet werden:

Nächste Schritte