eventMessage-Ressourcentyp
Namespace: microsoft.graph
Eine Nachricht, die eine Besprechungsanfrage, -absage oder -antwort darstellt. Mögliche Werte: acceptance, tentative acceptance oder decline.
Die eventMessage-Entität wird von message abgeleitet. eventMessage ist der Basistyp für eventMessageRequest und eventMessageResponse. Die meetingMessageType-Eigenschaft gibt den Typ der Ereignisnachricht an.
Wenn ein Organisator oder eine App eine Besprechungsanfrage sendet, gelangt die Besprechungsanfrage im Postfach eines eingeladenen Benutzers als eventMessage-instance mit dem meetingMessageType von meetingRequest ein. Darüber hinaus erstellt Outlook automatisch ein Ereignis instance im Kalender des eingeladenen Benutzers, wobei die showAs-Eigenschaft mit Vorbehalt verwendet wird.
Um die Eigenschaften des zugeordneten Ereignisses im Postfach des eingeladenen Benutzers abzurufen, kann die App die Ereignisnavigationseigenschaft der eventMessage verwenden, wie im Beispiel zum Abrufen einer Ereignisnachricht gezeigt. Die App kann auch programmgesteuert auf das Ereignis im Namen des eingeladenen Teilnehmers reagieren, indem sie das Ereignis akzeptiert, mit Vorbehalt akzeptiert oder abnimmt .
Abgesehen von einer Besprechungsanfrage kann eine eventMessage-instance im Postfach eines eingeladenen Benutzers gefunden werden, weil ein Ereignisorganisator eine Besprechung abbricht, oder im Postfach des Organisators, weil ein eingeladener Teilnehmer auf die Besprechungsanfrage antwortet. Eine App kann mit kleineren Abweichungen Aktionen sowohl bei Ereignisnachrichten als auch bei Nachrichten ausführen.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Get | eventMessage | Liest die Eigenschaften und Beziehungen eines eventMessage-Objekts. |
| Aktualisieren | eventMessage | Aktualisiert das eventMessage-Objekt. |
| Löschen | Keiner | Löscht das eventMessage-Objekt. |
| Nachricht kopieren | Nachricht | Kopiert eine Nachricht in einen Ordner. |
| Erstellen eines Entwurfs zum Weiterleiten einer Nachricht | Nachricht | Erstellt einen Entwurf der Weiterleitungsnachricht. Sie können den Entwurf dann aktualisieren oder senden. |
| Erstellen eines Entwurfs zum Beantworten einer Nachricht | Nachricht | Erstellt einen Entwurf der Antwortnachricht. Sie können den Entwurf dann aktualisieren oder senden. |
| Entwurf für „Allen antworten“ | Nachricht | Erstellt einen Entwurf der „Allen Antworten“-Nachricht. Sie können den Entwurf dann aktualisieren oder senden. |
| Nachricht weiterleiten | Keine | Leitet eine Nachricht weiter. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert. |
| Nachricht verschieben | Nachricht | 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 | 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 | ||
| List attachments | attachment-Sammlung | Ruft alle Anlagen für eine eventMessage ab. |
| Hinzufügen einer Anlage | attachment | Fügt einer eventMessage 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 | eventMessage | Erstellt eine oder mehrere einwertige erweiterte Eigenschaften in einer neuen oder vorhandenen eventMessage. |
| Einwertige Eigenschaft abrufen | eventMessage | Ruft mithilfe von $expand oder $filter eventMessages mit einer einwertigen erweiterten Eigenschaft ab. |
| Erweiterte mehrwertige Eigenschaft erstellen | eventMessage | Erstellt eine oder mehrere mehrwertige erweiterte Eigenschaften in einer neuen oder vorhandenen eventMessage. |
| Erweiterte mehrwertige Eigenschaft abrufen | eventMessage | Ruft unter Verwendung von $expand eine eventMessage ab, die eine mehrwertige erweiterte Eigenschaft enthält. |
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. |
| bodyPreview | String | Die ersten 255 Zeichen des Nachrichtentexts. Liegt im Textformat vor. |
| categories | String collection | Die Kategorien, die mit der Nachricht verknüpft sind. |
| 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. |
| 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. |
| ID | Zeichenfolge | Eindeutiger Bezeichner für die Ereignismeldung.
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 | String | Wichtigkeit der Nachricht: low, normal, high. |
| inferenceClassification | Zeichenfolge | Die möglichen Werte sind: focused, other. |
| internetMessageHeaders | InternetinternetMessageHeaders-Sammlung | Die Sammlung von Nachrichtenkopfzeilen, definiert von RFC5322, die Informationen des von einer Nachricht vom Absender bis zum Empfänger verwendeten Pfads einer Nachricht liefert. Schreibgeschützt. |
| internetMessageId | String | Die Nachrichten-ID im von RFC2822 angegebenen Format. |
| isDelegated | Boolescher Wert | True, wenn diese Besprechungsanfrage für einen Delegaten zugänglich ist, andernfalls false. Der Standardwert ist „false“. |
| 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, wenn sie noch nicht gesendet wurde. |
| isRead | Boolean | Gibt an, ob die Nachricht gelesen wird. |
| 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. |
| meetingMessageType | meetingMessageType | Der Typ der Ereignisnachricht: none, meetingRequest, meetingCancelled, meetingAccepted, meetingTenativelyAccepted, meetingDeclined. |
| 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. |
| 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. |
| Betreff | 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. |
| webLink | Zeichenfolge | Die URL zum Öffnen der Nachricht in Outlook im Web. Sie können ein ispopout Argument am Ende der URL anfügen, um zu ändern, wie die Meldung angezeigt wird. Wenn ispopout nicht vorhanden oder auf 1 festgelegt ist, wird die Meldung in einem Popupfenster 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 innerhalb eines iFrames zugegriffen werden. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| attachments | attachment-Sammlung | Schreibgeschützt. Lässt Nullwerte zu. |
| event | event | Das der Ereignisnachricht zugeordnete Ereignis. Bei Teilnehmern oder Raumressourcen wird davon ausgegangen, dass die Kalenderzentrale so festgelegt ist, dass der Kalender automatisch mit einem Ereignis aktualisiert wird, wenn Nachrichten zu Besprechungsanfragen eintreffen. Navigationseigenschaft. Schreibgeschützt |
| Erweiterungen | extension-Sammlung | Die Sammlung der für das Ereignis definierten offenen Erweiterungen. Schreibgeschützt. Nullwerte zulassend. |
| multiValueExtendedProperties | multiValueLegacyExtendedProperty-Sammlung | Die Sammlung der für die eventMessage definierten mehrwertigen erweiterten Eigenschaften. Schreibgeschützt. Nullwerte zulassend. |
| singleValueExtendedProperties | singleValueLegacyExtendedProperty-Sammlung | Die Sammlung der für die eventMessage definierten einwertigen erweiterten Eigenschaften. Schreibgeschützt. Nullwerte zulassend. |
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht 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": "DateTimeOffset",
"event": { "@odata.type": "microsoft.graph.event" },
"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",
"isDelegated": true,
"isDeliveryReceiptRequested": true,
"isDraft": true,
"isRead": true,
"isReadReceiptRequested": true,
"lastModifiedDateTime": "DateTimeOffset",
"meetingMessageType": "String",
"parentFolderId": "string",
"receivedDateTime": "DateTimeOffset",
"replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
"sender": {"@odata.type": "microsoft.graph.recipient"},
"sentDateTime": "DateTimeOffset",
"subject": "string",
"toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
"uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
"webLink": "string"
}