Feedback Bearbeiten

Nachrichtenressourcentyp

  • Artikel
  • 9 Minuten Lesedauer

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Eine Nachricht in einem Postfachordner.

Die maximale Gesamtzahl der in den Eigenschaften toRecipients, ccRecipients und bccRecipients enthaltenen Empfänger für eine einzelne E-Mail-Nachricht, die aus einem Exchange Online-Postfach gesendet wird, beträgt 500. Weitere Informationen finden Sie unter Sendegrenzwerte.

Diese Ressource unterstützt Folgendes:

  • Hinzufügen Ihrer eigenen Daten als benutzerdefinierte Internet-Nachrichtenkopfzeilen. Hinzufügen von benutzerdefinierten Kopfzeilen nur beim Erstellen einer Nachricht und Zuweisen eines mit „x-“ beginnenden Namens. Nachdem die Nachricht gesendet wurde, können Sie die Kopfzeilen nicht ändern. Um die Kopfzeilen einer Nachricht abzurufen, wenden Sie den Abfrageparameter $select in einem get message-Vorgang an.
  • Hinzufügen Ihrer eigenen Daten zu benutzerdefinierten Eigenschaften als Erweiterungen.
  • Abonnieren von Änderungsbenachrichtigungen.
  • Verwenden einer Delta-Abfrage zum Nachverfolgen von inkrementellen Hinzufügungen, Löschungen und Aktualisierungen durch Bereitstellen der delta-Funktion.

Methoden

Methode Rückgabetyp Beschreibung
Nachrichten auflisten Sammlung von Nachrichten Dient zum Abrufen aller Nachrichten im Postfach des angemeldeten Benutzers (einschließlich der Ordner „Gelöschte Elemente“ und „Clutter“).
Nachricht erstellen Nachricht Erstellt einen Entwurf einer neuen Nachricht.
Nachricht abrufen Nachricht Liest Eigenschaften und Beziehungen des Nachrichtenobjekts.
Aktualisieren Nachricht Aktualisiert das Nachrichtenobjekt.
Löschen Keiner Löscht das Nachrichtenobjekt.
Kopieren Nachricht Kopiert eine Nachricht in einen Ordner.
createForward Nachricht Erstellt einen Entwurf einer Weiterleitungsnachricht, um in einem createForward-Aufruf einen Kommentar einzuschließen oder Nachrichteneigenschaften zu aktualisieren. Sie können den Entwurf dann aktualisieren oder senden.
createReply Nachricht Erstellt einen Entwurf einer Antwortnachricht, um in einem createReply-Aufruf einen Kommentar einzuschließen oder Nachrichteneigenschaften zu aktualisieren. Sie können den Entwurf dann aktualisieren oder senden.
createReplyAll Nachricht Erstellt einen Entwurf einer Antwortnachricht an alle Empfänger, um in einem createReplyAll-Aufruf einen Kommentar einzuschließen oder Nachrichteneigenschaften zu aktualisieren. Sie können den Entwurf dann aktualisieren oder senden.
delta message-Sammlung Dient zum Abrufen eines Satzes von Nachrichten, die einem bestimmten Ordner hinzugefügt bzw. daraus gelöscht oder darin aktualisiert wurden.
forward Keine Leitet eine Nachricht weiter, fügt einen Kommentar hinzu oder ändert aktualisierbare Eigenschaften in einem forward-Aufruf. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert.
move Nachricht Verschiebt eine Nachricht in einen Ordner. Dadurch wird eine neue Kopie der Nachricht im Zielordner erstellt.
Antworten Keine Antwortet dem Absender einer Nachricht, fügt einen Kommentar hinzu oder ändert aktualisierbare Eigenschaften in einem reply-Aufruf. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert.
replyAll Keine Antwortet allen Empfänger einer Nachricht, indem durch Verwendung der replyAll-Methode ein Kommentar angegeben und alle aktualisierbaren Eigenschaften für die Antwort geändert werden. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert.
send Keine Sendet einen zuvor erstellten Nachrichtenentwurf. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert.
unsubscribe Keine Sendet eine Nachricht unter Verwendung der Daten und der Adresse, die im ersten mailto-Befehl im List-Unsubscribe-Header angegeben wurden.
Anlagen
Anlagen auflisten attachment-Sammlung Ruft alle Anlagen einer Nachricht ab.
Anlage hinzufügen Anlage Fügt einer Nachricht eine neue Anlage durch Veröffentlichen in der Anlagensammlung hinzu.
Offene Erweiterungen
Offene Erweiterung erstellen openTypeExtension Erstellt eine offene Erweiterung und fügt benutzerdefinierte Eigenschaften zu einer neuen oder vorhandenen Ressource hinzu.
Offene Erweiterung abrufen openTypeExtension-Sammlung Dient zum Abrufen einer offenen Erweiterung, die durch den Erweiterungsnamen identifiziert wird.
Schemaerweiterungen
Schemaerweiterungswerte hinzufügen Dient zum Erstellen einer Schemaerweiterungsdefinition und anschließenden Verwenden der Definition zum Hinzufügen benutzerdefinierter typisierter Daten zu einer Ressource.
Erweiterte Eigenschaften
Einwertige erweiterte Eigenschaft erstellen Nachricht Erstellt eine oder mehrere einwertige erweiterte Eigenschaften in einer neuen oder vorhandenen Nachricht.
Nachricht mit einwertiger erweiterter Eigenschaft abrufen Nachricht Ruft mithilfe von $expand oder $filter Nachrichten mit einer einwertigen erweiterten Eigenschaft ab.
Mehrwertige erweiterte Eigenschaft erstellen Nachricht Erstellt eine oder mehrere mehrwertige erweiterte Eigenschaften in einer neuen oder vorhandenen Nachricht.
Nachricht mit mehrwertiger erweiterter Eigenschaft abrufen Nachricht Ruft eine Nachricht mit einer mehrwertigen erweiterten Eigenschaft mithilfe von $expand ab.

Eigenschaften

Eigenschaft Typ Beschreibung
bccRecipients recipient collection Die Bcc:-Empfänger der Nachricht.
body itemBody Der Text der Nachricht. Er kann im HTML- oder Textformat vorliegen. Weitere Informationen zu sicherem HTML-Code in einem Nachrichtentext.
bodyPreview String Die ersten 255 Zeichen des Nachrichtentexts. Liegt im Textformat vor. Wenn die Nachricht Instanzen von mention enthält, würde diese Eigenschaft auch eine Verkettung dieser Erwähnungen enthalten.
categories String collection Die Kategorien, die der Nachricht zugeordnet sind. Jede Kategorie entspricht der Eigenschaft displayName einer für den Benutzer definierten outlookCategory.
ccRecipients recipient collection Die Cc:-Empfänger der Nachricht.
changeKey String Die Version der Nachricht.
conversationId String Die ID der Unterhaltung, zu der die E-Mail gehört.
conversationIndex Edm.Binary Gibt die Position der Nachricht in der Unterhaltung an.
createdDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der die Nachricht erstellt wurde.

Die Datums- und Uhrzeitinformationen verwenden das ISO 8601-Format und werden immer in UTC-Zeit angegeben. Mitternacht UTC am 1. Januar 2014 ist beispielsweise 2014-01-01T00:00:00Z.
Flag followupFlag Der Wert des Flags, der den Status, das Startdatum, das Fälligkeitsdatum oder das Enddatum für die Nachricht angibt.
Von Empfänger Der Besitzer des Postfachs, von dem die Nachricht gesendet wird. In den meisten Fällen ist dieser Wert identisch mit der Eigenschaft Sender, mit Ausnahme von Freigabe- und Delegierungsszenarios. Der Wert muss dem tatsächlich verwendeten Postfach entsprechen. Weitere Informationen über das Festlegen der Eigenschaften „from“ und „sender“ einer Nachricht.
hasAttachments Boolescher Wert Gibt an, ob die Nachricht Anlagen enthält. Diese Eigenschaft enthält keine Inline-Anlagen, wenn eine Nachrichtalso nur Inline-Anlagen enthält, ist diese Eigenschaft „false“. Um das Vorhandensein von Inline-Anlagen zu überprüfen, analysieren Sie die body-Eigenschaft so, dass nach einem src-Attribut, z. B. <IMG src="cid:image001.jpg@01D26CD8.6C05F070">, gesucht wird.
id Zeichenfolge Eindeutiger Bezeichner der Nachricht. Standardmäßig ändert sich dieser Wert, wenn das Element von einem Container (z. B. einem Ordner oder Kalender) in einen anderen verschoben wird. Verwenden Sie den Prefer: IdType="ImmutableId"-Header, um dieses Verhalten zu ändern. Weitere Informationen finden Sie unter Abrufen unveränderlicher Bezeichner für Outlook-Ressourcen. Schreibgeschützt.
Wichtigkeit Wichtigkeit Die Wichtigkeit der Nachricht. Die möglichen Werte sind low, normal und high.
inferenceClassification inferenceClassificationType Die Klassifizierung der Nachricht für den Benutzer, basierend auf der abgeleiteten Relevanz oder Wichtigkeit oder auf einer expliziten Außerkraftsetzung. Mögliche Werte sind: focused, other.
internetMessageHeaders internetinternetMessageHeaders-Sammlung Eine Sammlung von Nachrichtenkopfzeilen, definiert von RFC5322. Der Satz enthält Nachrichtenkopfzeilen, die den Netzwerkpfad angeben, den eine Nachricht vom Absender zum Empfänger nimmt. Er kann auch benutzerdefinierte Nachrichtenkopfzeilen umfassen, die App-Daten für die Nachricht enthalten.

Wird nur bei Anwenden einer $select-Abfrageoption zurückgegeben. Schreibgeschützt.
internetMessageId Zeichenfolge Die Nachrichten-ID in dem von RFC5322 festgelegten Format. Nur aktualisierbar, wenn isDraft TRUE ist.
isDeliveryReceiptRequested Boolean Zeigt an, ob für die Nachricht eine Lesebestätigung angefordert wird.
isDraft Boolean Gibt an, ob die Nachricht ein Entwurf ist. Eine Nachricht ist ein Entwurf, solange sie noch nicht gesendet wurde.
isRead Boolean Gibt an, ob die Nachricht gelesen wurde.
isReadReceiptRequested Boolean Zeigt an, ob für die Nachricht eine Lesebestätigung angefordert wird.
lastModifiedDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der die Nachricht zuletzt geändert wurde.

Die Datums- und Uhrzeitinformationen verwenden das ISO 8601-Format und werden immer in UTC-Zeit angegeben. Mitternacht UTC am 1. Januar 2014 ist beispielsweise 2014-01-01T00:00:00Z.
mentionsPreview mentionsPreview Informationen zu Erwähnungen in der Nachricht. Bei der Verarbeitung einer GET /messages-Anforderung legt der Server diese Eigenschaft fest und fügt sie standardmäßig in die Antwort ein. Der Server gibt Null zurück, wenn es in der Nachricht keine Erwähnungen gibt. Optional.
parentFolderId String Der eindeutige Bezeichner für das übergeordnete mailFolder-Element der Nachricht.
receivedDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der die Nachricht erhalten wurde.

Die Datums- und Uhrzeitinformationen verwenden das ISO 8601-Format und werden immer in UTC-Zeit angegeben. Mitternacht UTC am 1. Januar 2014 ist beispielsweise 2014-01-01T00:00:00Z.
replyTo recipient collection Die E-Mail-Adressen, die beim Antworten verwendet werden sollen.
sender Empfänger Das Konto, das tatsächlich verwendet wird, um die Nachricht zu generieren. In den meisten Fällen ist dieser Wert identisch mit dem der from-Eigenschaft. Sie können diese Eigenschaft auf einen anderen Wert festlegen, wenn Sie eine Nachricht aus einem freigegebenen Postfach, für einen freigegebenen Kalender oder als Stellvertretung senden. Der Wert muss auf jeden Fall dem tatsächlich verwendeten Postfach entsprechen. Weitere Informationen über das Festlegen der Eigenschaften „from“ und „sender“ einer Nachricht.
sentDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der die Nachricht gesendet wurde.

Die Datums- und Uhrzeitinformationen verwenden das ISO 8601-Format und werden immer in UTC-Zeit angegeben. Mitternacht UTC am 1. Januar 2014 ist beispielsweise 2014-01-01T00:00:00Z.
subject String Der Betreff der Nachricht.
toRecipients recipient collection Die An:-Empfänger der Nachricht.
uniqueBody itemBody Der Teil des Nachrichtentexts, der nur in der aktuellen Nachricht vorhanden ist. uniqueBody wird nicht standardmäßig zurückgegeben, kann aber für eine bestimmte Nachricht mithilfe der Abfrage ?$select=uniqueBody abgerufen werden. Er kann im HTML- oder Textformat vorliegen.
unsubscribeData String Die gültigen Einträge, die vom List-Unsubscribe-Header analysiert werden. Dies sind die Daten für den E-Mail-Befehl im List-Unsubscribe-Header, wenn die UnsubscribeeEnabled-Eigenschaft „true“ ist.
unsubscribeEnabled Boolesch Gibt an, ob die Nachricht zum Kündigen des Abonnements aktiviert ist. Wenn der list-Unsubscribe-Header „rfc-2369“ entspricht, ist der Wert „true“.
webLink Zeichenfolge Die URL zum Öffnen der Nachricht in Outlook im Web.

Sie können am Ende der URL das Argument „ispopout“ anhängen, um zu ändern, wie die Nachricht angezeigt wird. Wenn „ispopout“ nicht vorhanden oder auf 1 gesetzt ist, wird die Nachricht in einem Popout-Fenster angezeigt. Wenn „ispopout“ auf 0 gesetzt ist, zeigt der Browser die Nachricht im Überprüfungsbereich von Outlook im Web App an.

Die Nachricht wird im Browser geöffnet, wenn Sie über Outlook im Web bei Ihrem Postfach angemeldet sind. Wenn Sie noch nicht am Browser angemeldet sind, werden Sie aufgefordert, dies zu tun.

Auf diese URL kann nicht von einem iFrame aus zugegriffen werden.

Beziehungen

Beziehung Typ Beschreibung
Anlagen Anlagensammlung Die fileAttachment- und itemAttachment-Anlagen der Nachricht.
Erweiterungen Erweiterungssammlung Die Sammlung der für die Nachricht definierten offenen Erweiterungen. Nullwerte zulassend.
Erwähnungen Erwähnungssammlung Eine Sammlung von Erwähnungen in der Nachricht, sortiert nach createdDateTime vom neuesten zum ältesten Element. Standardmäßig gibt GET /message diese Eigenschaft nicht zurück, es sei denn, Sie wenden $expand auf die Eigenschaft an.
multiValueExtendedProperties multiValueLegacyExtendedProperty-Sammlung Die Sammlung von mehrwertigen erweiterten Eigenschaften, die für die Nachricht definiert sind. Nullbar.
singleValueExtendedProperties singleValueLegacyExtendedProperty-Sammlung Die Sammlung der für die Nachricht definierten einwertigen erweiterten Eigenschaften. Nullbar.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "bccRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "bodyPreview": "string",
  "categories": ["string"],
  "ccRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "changeKey": "string",
  "conversationId": "string",
  "conversationIndex": "String (binary)",
  "createdDateTime": "String (timestamp)",
  "flag": {"@odata.type": "microsoft.graph.followupFlag"},
  "from": {"@odata.type": "microsoft.graph.recipient"},
  "hasAttachments": true,
  "id": "string (identifier)",
  "importance": "String",
  "inferenceClassification": "String",
  "internetMessageHeaders": [{"@odata.type": "microsoft.graph.internetMessageHeader"}],
  "internetMessageId": "String",
  "isDeliveryReceiptRequested": true,
  "isDraft": true,
  "isRead": true,
  "isReadReceiptRequested": true,
  "lastModifiedDateTime": "String (timestamp)",
  "mentionsPreview": {"@odata.type": "microsoft.graph.mentionsPreview"},
  "parentFolderId": "string",
  "receivedDateTime": "String (timestamp)",
  "replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
  "sender": {"@odata.type": "microsoft.graph.recipient"},
  "sentDateTime": "String (timestamp)",
  "subject": "string",
  "toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
  "unsubscribeData": "string",
  "unsubscribeEnabled": true,
  "webLink": "string",

  "attachments": [{"@odata.type": "microsoft.graph.attachment"}],
  "extensions": [{"@odata.type": "microsoft.graph.extension"}],
  "mentions": [{"@odata.type": "microsoft.graph.mention"}],
  "multiValueExtendedProperties": [{"@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty"}],
  "singleValueExtendedProperties": [{"@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty"}]
}

Siehe auch