eventMessage-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

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. Event Message 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, wird die Besprechungsanfrage als Event Message -Instanz eines invitee-Postfachs mit dem meetingMessageType von meetingRequest. Darüber hinaus erstellt Outlook automatisch eine Ereignis Instanz im Kalender der Einladung, wobei die Eigenschaft " Eigenschaften" als " vorläufig" fest steht.

Um die Eigenschaften des zugeordneten Ereignisses im Postfach des eingeladenen Benutzers abzurufen, kann die APP die Ereignis Navigationseigenschaft des Event Messageverwenden, wie in diesem Ereignis Beispiel für GET-Nachrichtdargestellt. Die APP kann auch auf das Ereignis im Namen der eingeladenen programmgesteuert reagieren, indem Sie das Ereignis annehmen, mit Vorbehalt annehmenoder ablehnen .

Neben einer Besprechungsanfrage befindet sich eine Event Message -Instanz im Postfach eines Inhabers als Ergebnis einer Ereignis Organisation, die eine Besprechung abbricht, oder im Postfach des Organisators als Ergebnis einer Einladung, die auf die Besprechungsanfrage reagiert. Eine App kann mit kleineren Abweichungen Aktionen sowohl bei Ereignisnachrichten als auch bei Nachrichten ausführen.

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",
  "endDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "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",
  "isAllDay": "Boolean",
  "isDelegated": true,
  "isDeliveryReceiptRequested": true,
  "isDraft": true,
  "isOutOfDate": "Boolean",
  "isRead": true,
  "isReadReceiptRequested": true,
  "lastModifiedDateTime": "DateTimeOffset",
  "location": {"@odata.type": "microsoft.graph.location"},
  "meetingMessageType": {"@odata.type": "microsoft.graph.meetingMessageType"},
  "mentionsPreview": {"@odata.type": "microsoft.graph.mentionsPreview"},
  "parentFolderId": "string",
  "receivedDateTime": "DateTimeOffset",
  "recurrence": {"@odata.type": "microsoft.graph.patternedRecurrence"},
  "replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
  "sender": {"@odata.type": "microsoft.graph.recipient"},
  "sentDateTime": "DateTimeOffset",
  "startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "subject": "string",
  "toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "type": "string",
  "uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
  "UnsubscribeData": "string",
  "UnsubscribeEnabled": true,
  "webLink": "string"
}

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.
endDateTime	dateTimeTimeZone	Die Endzeit der angeforderten Besprechung.
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	Zeichenfolge	Eindeutiger Bezeichner der Nachricht. By default, this value changes when the item is moved from one container (such as a folder or calendar) to another. To change this behavior, use the Prefer: IdType="ImmutableId" header. See Get immutable identifiers for Outlook resources for more information. Schreibgeschützt.
Wichtigkeit	String	Wichtigkeit der Nachricht: low, normal, high.
inferenceClassification	Zeichenfolge	Mögliche Werte: 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	Zeichenfolge	Die Nachrichten-ID im von RFC5322 angegebenen Format.
isAllDay	Boolean	Gibt an, ob das Ereignis den ganzen Tag dauert. Für das Anpassen dieser Eigenschaft müssen auch die Eigenschaften StartDateTime und EndDate -Datum des Ereignisses angepasst werden.
isdelegated wurde	Boolesch	True, wenn eine Stellvertretung auf diese Besprechungsanfrage zugreifen 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.
isOutOfDate	Boolesch	Gibt an, ob diese Besprechungsanfrage durch eine aktuellere Anforderung veraltet ist.
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.
location	location	Der Speicherort der angeforderten Besprechung.
meetingMessageType	String	Der Typ der Ereignisnachricht: none, meetingRequest, meetingCancelled, meetingAccepted, meetingTentativelyAccepted, meetingDeclined.
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.
recurrence	patternedRecurrence	Das Serienmuster der angeforderten Besprechung.
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.
startDateTime	dateTimeTimeZone	Die Startzeit der angeforderten Besprechung.
subject	String	Der Betreff der Nachricht.
toRecipients	recipient collection	Die An:-Empfänger der Nachricht.
type	Zeichenfolge	Der Typ der angeforderten Besprechung: singleInstance , occurence , exception , seriesMaster .
uniqueBody	itemBody	Der Teil des Textkörpers der Nachricht, der für die aktuelle Nachricht eindeutig ist.
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 Internet. 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, wird die Nachricht im Browser im Outlook im WebReview-Bereich angezeigt. Die Nachricht wird im Browser geöffnet, wenn Sie über Outlook im Internet bei Ihrem Postfach angemeldet sind. Sie werden aufgefordert, sich anzumelden, wenn Sie noch nicht beim Browser angemeldet sind. Auf diese URL kann innerhalb eines iframes nicht zugegriffen werden.

Beziehungen

Beziehung	Typ	Beschreibung
attachments	attachment collection	Die Auflistung von FileAttachment-, itemAttachment-und referenceAttachment -Anlagen für die Nachricht. 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.
extensions	extension-Sammlung	Die Sammlung der für das Ereignis definierten offenen Erweiterungen. Schreibgeschützt. Lässt NULL-Werte zu.
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 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.

Methoden

Methode	Rückgabetyp	Beschreibung
eventMessage abrufen	eventMessage	Liest die Eigenschaften und Beziehungen eines eventMessage-Objekts.
Aktualisieren	eventMessage	Aktualisiert das eventMessage-Objekt.
Delete	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.
unsubscribe	Keine	Sendet eine Nachricht unter Verwendung der Daten und der Adresse, die im ersten mailto-Befehl im List-Unsubscribe-Header angegeben wurden.
Anlagen
List attachments	attachment collection	Ruft alle Anlagen für eine eventMessage ab.
Anlage hinzufügen	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	Rufen Sie eine offene Erweiterung ab, die durch den Namen identifiziert wird.
Erweiterte Eigenschaften
Create single-value extended property	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.