eventMessage-Ressourcentyp

Namespace: microsoft.graph

Eine Nachricht, die für eine Besprechungsanfrage, -absage oder -antwort steht (diese kann folgende umfassen: Zusage, Zusage mit Vorbehalt oder Absage).

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, trifft die Besprechungsanfrage im Postfach eines eingeladenen Benutzers als eventMessage-Instanz mit dem meetingMessageType von meetingRequest ein. Darüber hinaus erstellt Outlook automatisch eine Ereignisinstanz im Kalender des eingeladenen Benutzers, wobei die eigenschaft showAs mit Vorbehalt ausgeführt wird.

Um die Eigenschaften des zugeordneten Ereignisses im Postfach des eingeladenen Benutzers abzurufen, kann die App die Ereignisnavigationseigenschaft der eventMessage verwenden, wie in diesem Beispiel für die Get-Ereignisnachrichtgezeigt. Die App kann auch programmgesteuert auf das Ereignis reagieren, indem sie das Ereignis mit Vorbehalt akzeptiertoder zurückweist.

Abgesehen von einer Besprechungsanfrage kann eine eventMessage-Instanz im Postfach eines eingeladenen Benutzers gefunden werden, wenn ein Ereignisorganisator eine Besprechung absagt, oder im Postfach des Organisators als Ergebnis einer Antwort eines eingeladenen Teilnehmers auf die Besprechungsanfrage. Eine App kann mit kleineren Abweichungen Aktionen sowohl bei Ereignisnachrichten als auch bei Nachrichten ausführen.

Methoden

Methode	Rückgabetyp	Beschreibung
eventMessage abrufen	eventMessage	Liest die Eigenschaften und Beziehungen eines eventMessage-Objekts.
Aktualisieren	eventMessage	Aktualisiert das eventMessage-Objekt.
Löschen	Keine	Löscht das eventMessage-Objekt.
copy	message	Kopiert eine Nachricht in einen Ordner.
createForward	message	Erstellt einen Entwurf der Weiterleitungsnachricht. Sie können den Entwurf dann aktualisieren oder senden.
createReply	message	Erstellt einen Entwurf der Antwortnachricht. Sie können den Entwurf dann aktualisieren oder senden.
createReplyAll	message	Erstellt einen Entwurf der „Allen Antworten“-Nachricht. Sie können den Entwurf dann aktualisieren oder senden.
forward	Keine	Leitet eine Nachricht weiter. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert.
Verschieben	message	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.
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.
Anlage hinzufügen	Anlage	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 erweiterte Eigenschaft erstellen	eventMessage	Erstellt eine oder mehrere einwertige erweiterte Eigenschaften in einer neuen oder vorhandenen eventMessage.
eventMessage mit einer einwertigen erweiterten Eigenschaft abrufen	eventMessage	Ruft mithilfe von $expand oder $filter eventMessages mit einer einwertigen erweiterten Eigenschaft ab.
Mehrwertige erweiterte Eigenschaft erstellen	eventMessage	Erstellt eine oder mehrere mehrwertige erweiterte Eigenschaften in einer neuen oder vorhandenen eventMessage.
eventMessage mit mehrwertiger erweiterter 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	Boolescher Wert	Gibt an, ob die Nachricht Anlagen enthält.
id	String	Eindeutiger Bezeichner für die Ereignisnachricht (beachten Sie, dass sich dieser Wert ändern kann, wenn eine Nachricht verschoben oder geändert wird)
Wichtigkeit	String	Wichtigkeit der Nachricht: low, normal, high.
inferenceClassification	String	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 auf diese Besprechungsanfrage für einen Delegaten zugegriffen werden kann, 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, 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.
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 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 gesetzt ist, zeigt der Browser die Nachricht 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 beim Browser angemeldet sind. Auf diese URL kann nicht von einem iFrame aus zugegriffen werden.

Beziehungen

Beziehung	Typ	Beschreibung
attachments	attachment-Sammlung	Schreibgeschützt. Lässt Nullwerte zu.
event	event	Das Ereignis, das der Ereignisnachricht zugeordnet ist. Für Teilnehmer oder Raumressourcen wird davon ausgegangen, dass die Kalenderautomatik für die automatische Aktualisierung des Kalenders mit einem Ereignis festgelegt ist, wenn Ereignisnachrichten mit Besprechungsanfragen eingehen Navigationseigenschaft. Schreibgeschützt.
Erweiterungen	extension-Sammlung	Die Sammlung der für das Ereignis definierten offenen Erweiterungen. Schreibgeschützt. Lässt NULL-Werte zu.
multiValueExtendedProperties	multiValueLegacyExtendedProperty-Sammlung	Die Sammlung der für die eventMessage definierten mehrwertigen erweiterten Eigenschaften. Schreibgeschützt. Lässt Nullwerte zu.
singleValueExtendedProperties	singleValueLegacyExtendedProperty-Sammlung	Die Sammlung der für die eventMessage definierten einwertigen erweiterten Eigenschaften. Schreibgeschützt. Lässt Nullwerte zu.

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