eventMessage-Ressourcentyp

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, 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, 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 in diesem 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 Organisator eine Besprechung abgesagt hat, 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.

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": "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	Boolean	Gibt an, ob die Nachricht Anlagen enthält.
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	String	Wichtigkeit der Nachricht: low, normal, high.
inferenceClassification	String	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	Boolesch	Gibt an, ob das Ereignis den ganzen Tag dauert. Zum Anpassen dieser Eigenschaft müssen auch die Eigenschaften startDateTime und endDateTime des Ereignisses angepasst werden.
isDelegated	Boolesch	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, solange sie noch nicht gesendet wurde.
isOutOfDate	Boolesch	Gibt an, ob diese Besprechungsanfrage von einer neueren 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 Ort 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	String	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 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	Die Auflistung der FileAttachment-, itemAttachment- und referenceAttachment-Anlagen für die Nachricht. 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.
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. Nullwerte zulassend.
singleValueExtendedProperties	singleValueLegacyExtendedProperty-Sammlung	Die Sammlung der für die eventMessage definierten einwertigen erweiterten Eigenschaften. Schreibgeschützt. Nullwerte zulassend.

Methoden

Methode	Rückgabetyp	Beschreibung
eventMessage abrufen	eventMessage	Liest die Eigenschaften und Beziehungen eines eventMessage-Objekts.
Aktualisieren	eventMessage	Aktualisiert das eventMessage-Objekt.
Löschen	Keiner	Löscht das eventMessage-Objekt.
copy	message	Mit dieser API können Sie Nachrichten in Ordner kopieren.
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.
Weiterleiten	Keine	Leitet eine Nachricht weiter. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert.
move	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.
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
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	Rufen Sie eine durch den Namen identifizierte offene Erweiterung 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.