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
$selectin 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 | Ruft einen Satz von Nachrichten ab, die in einem angegebenen Ordner hinzugefügt, gelöscht oder 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. |
| markAsJunk | 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-Email Ordner, wenn moveToJunk isttrue. |
| markAsNotJunk | Nachricht | 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. |
| 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. |
| 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 Outlook im Web Überprüfungsbereich 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"}]
}
Verwandte Inhalte
- Postfacheinstellungen abrufen
- Postfacheinstellungen aktualisieren
- Verwenden einer Delta-Abfrage zum Nachverfolgen von Änderungen in Microsoft Graph-Daten
- Inkrementelle Änderungen an Nachrichten in einem Ordner abrufen
- Hinzufügen von benutzerdefinierten Daten zu Ressourcen mithilfe von Erweiterungen
- Hinzufügen von benutzerdefinierten Daten zu Benutzern mithilfe offener Erweiterungen
- Hinzufügen von benutzerdefinierten Daten zu Gruppen mithilfe von Schemaerweiterungen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für