Teilen über


Nachrichtenressourcentyp

Namespace: microsoft.graph

Dieser Ressourcentyp stellt eine Nachricht in einem mailFolder-Objekt dar.

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 der Weiterleitungsnachricht. Sie können den Entwurf dann aktualisieren oder senden.
Erstellen eines Entwurfs für die Antwort Meldung Erstellt einen Entwurf der Antwortnachricht. Sie können den Entwurf dann aktualisieren oder senden.
Erstellen eines Entwurfs für alle Antworten Meldung Erstellt einen Entwurf der „Allen Antworten“-Nachricht. 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. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert.
Nachricht verschieben Meldung Verschiebt eine Nachricht in einen Ordner. Dadurch wird eine neue Kopie der Nachricht im Zielordner erstellt.
Antworten auf eine Nachricht Keine Antwortet auf eine Nachricht des Absenders. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert.
Allen antworten auf eine Nachricht Keine Sendet eine Antwort an alle Empfänger einer E-Mail. 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.
Anlagen
Anlagen auflisten Anlagensammlung Ruft alle Anlagen in einer Nachricht ab.
Hinzufügen einer Anlage 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 in einer neuen oder vorhandenen Instanz einer Ressource hinzu.
Offene Erweiterung abrufen openTypeExtension-Sammlung Ruft ein offenes Erweiterungsobjekt oder Objekte basierend auf ihrem Namen oder vollqualifizierten Namen ab.
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.
Erstellen einer mehrwertigen Eigenschaft Nachricht Erstellt eine oder mehrere mehrwertige erweiterte Eigenschaften in einer neuen oder vorhandenen Nachricht.
Abrufen einer mehrwertigen Eigenschaft 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.
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. Die möglichen Werte sind: focused oder 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 String Die Nachrichten-ID im von RFC2822 angegebenen Format.
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.
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.
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
attachments attachment-Sammlung Die fileAttachment- und itemAttachment-Anlagen der Nachricht.
Erweiterungen extension-Sammlung Die Sammlung der für die Nachricht definierten offenen Erweiterungen. Nullwerte zulassend.
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

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "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)",
  "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"},
  "webLink": "string",

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