Freigeben über


Nachrichtenressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

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 erhalten Sie unter Sendelimits.

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 Header nicht mehr ä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“).
Erstellen eines Nachrichtenentwurfs Nachricht Erstellt einen Entwurf einer neuen Nachricht.
Nachricht abrufen Nachricht Liest Eigenschaften und Beziehungen des Nachrichtenobjekts.
Nachricht aktualisieren Nachricht Aktualisiert das Nachrichtenobjekt.
Nachricht löschen Keiner Löscht das Nachrichtenobjekt.
Nachricht kopieren Nachricht Kopiert eine Nachricht in einen Ordner.
Erstellen eines Entwurfs zum Weiterleiten einer Nachricht Meldung 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.
Erstellen eines Entwurfs zum Beantworten einer Nachricht Meldung 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.
Entwurf für „Allen antworten“ Meldung 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.
Nachricht-Delta abrufen message-Sammlung Ruft einen Satz von Nachrichten ab, die in einem angegebenen Ordner hinzugefügt, gelöscht oder aktualisiert wurden.
Nachricht weiterleiten 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.
Als Junk markieren message Markieren Sie eine Nachricht als Junk-E-Mail. Diese API fügt den Absender der Liste der blockierten Absender hinzu und verschiebt die Nachricht in den Junk-E-Mail-Ordner , wenn moveToJunk den Wert hat true.
Als nicht junk markieren message Markieren Sie eine Nachricht als keine Junk-E-Mail. Diese API entfernt den Absender aus der Liste der blockierten Absender und verschiebt die Nachricht in den Ordner Posteingang , wenn moveToInbox den Wert aufweist true.
Nachricht verschieben Meldung Verschiebt eine Nachricht in einen Ordner. Diese API erstellt eine neue Kopie der Nachricht im Zielordner.
Antworten auf eine Nachricht 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.
Allen antworten auf Nachricht 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.
Nachrichtenentwurf senden Keine Sendet einen zuvor erstellten Nachrichtenentwurf. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert.
Rückrufnachricht Nachricht Rufen Sie eine Nachricht im Ordner "Gesendete Elemente" des angegebenen Benutzers zurück.
Unsubscribe Keine Sendet eine Nachricht unter Verwendung der Daten und der Adresse, die im ersten mailto-Befehl im List-Unsubscribe-Header angegeben wurden.
Endgültig löschen Keine Löschen Sie eine Nachricht endgültig, und speichern Sie sie im Ordner Löschvorgänge im Ordner Wiederherstellbare Elemente im Postfach des Benutzers.
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.
Erweiterte Eigenschaften
Einwertige Eigenschaft erstellen Nachricht Erstellt eine oder mehrere einwertige erweiterte Eigenschaften in einer neuen oder vorhandenen Nachricht.
Einwertige Eigenschaft abrufen Nachricht Ruft mithilfe von $expand oder $filter Nachrichten mit einer einwertigen erweiterten Eigenschaft ab.
Erweiterte mehrwertige Eigenschaft erstellen Nachricht Erstellt eine oder mehrere mehrwertige erweiterte Eigenschaften in einer neuen oder vorhandenen Nachricht.
Erweiterte mehrwertige 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.
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 sind im ISO 8601-Format dargestellt und werden immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 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 Boolean Gibt an, ob die Nachricht Anlagen enthält. Diese Eigenschaft enthält keine Inlineanlagen. Wenn eine Nachricht also nur Inlineanlagen enthält, ist diese Eigenschaft false. Um das Vorhandensein von Inlineanlagen zu überprüfen, analysieren Sie die body-Eigenschaft, <IMG src="cid:image001.jpg@01D26CD8.6C05F070">um nach einem src Attribut wie zu suchen.
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: 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 im von RFC5322 angegebenen Format. Kann nur aktualisiert werden, 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 sind im ISO 8601-Format dargestellt und werden immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 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 sind im ISO 8601-Format dargestellt und werden immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 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 sind im ISO 8601-Format dargestellt und werden immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 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 Textkörpers der Nachricht, der für die aktuelle Nachricht eindeutig ist. uniqueBody wird standardmäßig nicht zurückgegeben, kann aber mithilfe der ?$select=uniqueBody Abfrage für eine bestimmte Nachricht 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 festgelegt ist, wird die Nachricht in einem Popout-Fenster angezeigt. Wenn ispopout auf 0 festgelegt ist, zeigt der Browser die Meldung im Überprüfungsbereich von Outlook im Web an.

Die Nachricht wird im Browser geöffnet, wenn Sie über Outlook im Web bei Ihrem Postfach angemeldet sind. Sie werden aufgefordert, sich anzumelden, wenn Sie noch nicht mit dem Browser angemeldet sind.

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 der für die Nachricht definierten mehrwertigen erweiterten Eigenschaften. Nullwerte zulassend.
singleValueExtendedProperties singleValueLegacyExtendedProperty-Sammlung Die Sammlung der für die Nachricht definierten einwertigen erweiterten Eigenschaften. Nullwerte zulassend.

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"}]
}