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
$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 der Weiterleitungsnachricht. Sie können den Entwurf dann aktualisieren oder senden. |
| createReply | Nachricht | Erstellt einen Entwurf der Antwortnachricht. Sie können den Entwurf dann aktualisieren oder senden. |
| createReplyAll | Nachricht | Erstellt einen Entwurf der „Allen Antworten“-Nachricht. 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. 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 auf eine Nachricht des Absenders. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert. |
| replyAll | Keine | Sendet eine Antwort an alle Empfänger einer E-Mail. 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. |
| 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. |
| 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. |
| 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 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 |
|---|---|---|
| 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"}]
}
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