eventMessage-Ressourcentyp

  • Artikel

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, 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.

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.
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 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 Boolean Gibt an, ob die Nachricht Anlagen enthält.
ID String 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 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 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.
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 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 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",
  "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"
}