eventMessage-RessourcentypeventMessage resource type

Eine Nachricht, die für eine Besprechungsanfrage, -absage oder -antwort steht (diese kann folgende umfassen: Zusage, Zusage mit Vorbehalt oder Absage).A message that represents a meeting request, cancellation, or response (which can be one of the following: acceptance, tentative acceptance, or decline).

Die eventMessage-Entität wird von message abgeleitet.The eventMessage entity is derived from message. Die meetingMessageType-Eigenschaft gibt den Typ der Ereignisnachricht an.The meetingMessageType property identifies the type of the event message.

Wenn ein Organisator oder eine App eine Besprechungsanfrage sendet, trifft die Besprechungsanfrage als eine eventMessage-Instanz mit meetingMessageType von meetingRequest in dem Postfach des Teilnehmers ein.When an organizer or app sends a meeting request, the meeting request arrives in an attendee's Inbox as an eventMessage instance with the meetingMessageType of meetingRequest. Darüber hinaus erstellt Outlook automatisch eine event-Instanz im Kalender des Teilnehmers mit der showAs-Eigenschaft als tentative.In addition, Outlook automatically creates an event instance in the attendee's calendar, with the showAs property as tentative.

Um die Eigenschaften des zugeordneten Ereignisses im Postfach des Teilnehmers abzurufen, kann die App die event-Navigationseigenschaft von eventMessage verwenden, wie in diesem Beispiel zum Abrufen von Ereignisnachrichten dargestellt.To get the properties of the associated event in the attendee's mailbox, the app can use the event navigation property of the eventMessage, as shown in this get event message example. Die app kann auch auf das Ereignis im Namen der Teilnehmer programmgesteuert akzeptieren, mit Vorbehalt annehmenoder Ablehnen des Ereignisses reagieren.The app can also respond to the event on behalf of the attendee programmatically, by accepting, tentatively accepting, or declining the event.

Neben dem, einer Besprechungsanfrage kann eine EventMessage Instanz eines Teilnehmers Remoteelement in dem Ordner als Ergebnis der Organisator des Ereignisses Abbrechen einer Besprechung oder in der Organisator Posteingang aufgrund eines Teilnehmers reagiert auf die Besprechungsanfrage gefunden werden.Aside from a meeting request, an eventMessage instance can be found in an attendee's Inbox folder as the result of an event organizer cancelling a meeting, or in the organizer's Inbox as a result of an attendee responding to the meeting request. Eine App kann mit kleineren Abweichungen Aktionen sowohl bei Ereignisnachrichten als auch bei Nachrichten ausführen.An app can act on event messages in the same way as on messages with minor differences.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
eventMessage abrufenGet eventMessage eventMessageeventMessage Liest die Eigenschaften und Beziehungen eines eventMessage-Objekts.Read properties and relationships of eventMessage object.
AktualisierenUpdate eventMessageeventMessage Aktualisiert das eventMessage-Objekt.Update eventMessage object.
LöschenDelete KeinerNone Löscht das eventMessage-Objekt.Delete eventMessage object.
copycopy messagemessage Mit dieser API können Sie Nachrichten in Ordner kopieren.Copy a message to a folder.
createForwardcreateForward messagemessage Erstellt einen Entwurf der Weiterleitungsnachricht. Sie können den Entwurf dann aktualisieren oder senden.Create a draft of the Forward message. You can then update or send the draft.
createReplycreateReply messagemessage Erstellt einen Entwurf der Antwortnachricht. Sie können den Entwurf dann aktualisieren oder senden.Create a draft of the Reply message. You can then update or send the draft.
createReplyAllcreateReplyAll messagemessage Erstellt einen Entwurf der „Allen Antworten“-Nachricht. Sie können den Entwurf dann aktualisieren oder senden.Create a draft of the Reply All message. You can then update or send the draft.
Weiterleitenforward KeineNone Leitet eine Nachricht weiter. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert.Forward a message. The message is then saved in the Sent Items folder.
movemove messagemessage Verschiebt eine Nachricht in einen Ordner. Dadurch wird eine neue Kopie der Nachricht im Zielordner erstellt.Move a message to a folder. This creates a new copy of the message in the destination folder.
Antwortenreply KeineNone Antwortet auf eine Nachricht des Absenders. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert.Reply to the sender of a message. The message is then saved in the Sent Items folder.
replyAllreplyAll KeineNone Sendet eine Antwort an alle Empfänger einer E-Mail. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert.Reply to all recipients of a message. The message is then saved in the Sent Items folder.
Sendensend KeineNone Sendet einen zuvor erstellten Nachrichtenentwurf. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert.Sends a previously created message draft. The message is then saved in the Sent Items folder.
AnlagenAttachments
List attachmentsList attachments attachment-Sammlungattachment collection Ruft alle Anlagen für eine eventMessage ab.Get all attachments on an eventMessage.
Hinzufügen einer AnlageAdd attachment attachmentattachment Fügt einer eventMessage eine neue Anlage durch Veröffentlichen in der Anlagensammlung hinzu.Add a new attachment to an eventMessage by posting to the attachments collection.
Offene ErweiterungenOpen extensions
Offene Erweiterung erstellenCreate open extension openTypeExtensionopenTypeExtension Erstellt eine offene Erweiterung und fügt benutzerdefinierte Eigenschaften in einer neuen oder vorhandenen Instanz einer Ressource hinzu.Create an open extension and add custom properties in a new or existing instance of a resource.
Offene Erweiterung abrufenGet open extension openTypeExtension-SammlungopenTypeExtension collection Ruft ein offenes Erweiterungsobjekt oder Objekte basierend auf ihrem Namen oder vollqualifizierten Namen ab.Get an open extension object or objects identified by name or fully qualified name.
Erweiterte EigenschaftenExtended properties
Einwertige erweiterte Eigenschaft erstellenCreate single-value extended property eventMessageeventMessage Erstellt eine oder mehrere einwertige erweiterte Eigenschaften in einer neuen oder vorhandenen eventMessage.Create one or more single-value extended properties in a new or existing eventMessage.
eventMessage mit einer einwertigen erweiterten Eigenschaft abrufenGet eventMessage with single-value extended property eventMessageeventMessage Ruft mithilfe von $expand oder $filter eventMessages mit einer einwertigen erweiterten Eigenschaft ab.Get eventMessages that contain a single-value extended property by using $expand or $filter.
Mehrwertige erweiterte Eigenschaft erstellenCreate multi-value extended property eventMessageeventMessage Erstellt eine oder mehrere mehrwertige erweiterte Eigenschaften in einer neuen oder vorhandenen eventMessage.Create one or more multi-value extended properties in a new or existing eventMessage.
eventMessage mit mehrwertiger erweiterter Eigenschaft abrufenGet eventMessage with multi-value extended property eventMessageeventMessage Ruft unter Verwendung von $expand eine eventMessage ab, die eine mehrwertige erweiterte Eigenschaft enthält.Get an eventMessage that contains a multi-value extended property by using $expand.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
bccRecipientsbccRecipients recipient collectionrecipient collection Die Bcc:-Empfänger der Nachricht.The Bcc: recipients for the message.
bodybody itemBodyitemBody Der Text der Nachricht. Er kann im HTML- oder Textformat vorliegen.The body of the message. It can be in HTML or text format.
bodyPreviewbodyPreview StringString Die ersten 255 Zeichen des Nachrichtentexts. Liegt im Textformat vor.The first 255 characters of the message body. It is in text format.
categoriescategories ZeichenfolgenauflistungString collection Die Kategorien, die mit der Nachricht verknüpft sind.The categories associated with the message.
ccRecipientsccRecipients recipient collectionrecipient collection Die Cc:-Empfänger der Nachricht.The Cc: recipients for the message.
changeKeychangeKey StringString Die Version der Nachricht.The version of the message.
conversationIdconversationId StringString Die ID der Unterhaltung, zu der die E-Mail gehört.The ID of the conversation the email belongs to.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Das Datum und die Uhrzeit, zu der die Nachricht erstellt wurde.The date and time the message was created.
Flagflag followupFlagfollowupFlag Der Wert des Flags, der den Status, das Startdatum, das Fälligkeitsdatum oder das Enddatum für die Nachricht angibt.The flag value that indicates the status, start date, due date, or completion date for the message.
Vonfrom Empfängerrecipient Der Postfachbesitzer und der Absender der Nachricht.The mailbox owner and sender of the message.
hasAttachmentshasAttachments BooleanBoolean Gibt an, ob die Nachricht Anlagen enthält.Indicates whether the message has attachments.
IDid StringString Eindeutiger Bezeichner für die ereignismeldung (Beachten Sie, die diesen Wert ändern kann, wenn eine Nachricht verschoben oder geändert wird)Unique identifier for the event message (note that this value may change if a message is moved or altered)
Wichtigkeitimportance StringString Wichtigkeit der Nachricht: low, normal, high.The importance of the message: low, normal, high.
inferenceClassificationinferenceClassification StringString Die möglichen Werte sind: focused, other.The possible values are: focused, other.
internetMessageHeadersinternetMessageHeaders internetinternetMessageHeaders-SammlunginternetMessageHeader collection Die Sammlung von Nachrichtenkopfzeilen, definiert von RFC5322, die Informationen des von einer Nachricht vom Absender bis zum Empfänger verwendeten Pfads einer Nachricht liefert.The collection of message headers, defined by RFC5322, that provide details of the network path taken by a message from the sender to the recipient. Schreibgeschützt.Read-only.
internetMessageIdinternetMessageId StringString Die Nachrichten-ID im von RFC2822 angegebenen Format.The message ID in the format specified by RFC2822.
isDeliveryReceiptRequestedisDeliveryReceiptRequested BooleanBoolean Zeigt an, ob für die Nachricht eine Lesebestätigung angefordert wird.Indicates whether a read receipt is requested for the message.
isDraftisDraft Boolescher WertBoolean Gibt an, ob die Nachricht ein Entwurf ist. Eine Nachricht ist ein Entwurf, solange sie noch nicht gesendet wurde.Indicates whether the message is a draft. A message is a draft if it hasn't been sent yet.
isReadisRead BooleanBoolean Gibt an, ob die Nachricht gelesen wurde.Indicates whether the message has been read.
isReadReceiptRequestedisReadReceiptRequested Boolescher WertBoolean Zeigt an, ob für die Nachricht eine Lesebestätigung angefordert wird.Indicates whether a read receipt is requested for the message.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Das Datum und die Uhrzeit, zu der die Nachricht zuletzt geändert wurde.The date and time the message was last changed.
meetingMessageTypemeetingMessageType meetingMessageTypemeetingMessageType Der Typ der Ereignisnachricht: none, meetingRequest, meetingCancelled, meetingAccepted, meetingTenativelyAccepted, meetingDeclined.The type of event message: none, meetingRequest, meetingCancelled, meetingAccepted, meetingTenativelyAccepted, meetingDeclined.
parentFolderIdparentFolderId StringString Der eindeutige Bezeichner für das übergeordnete mailFolder-Element der Nachricht.The unique identifier for the message's parent mailFolder.
receivedDateTimereceivedDateTime DateTimeOffsetDateTimeOffset Das Datum und die Uhrzeit, zu der die Nachricht erhalten wurde.The date and time the message was received.
replyToreplyTo recipient collectionrecipient collection Die E-Mail-Adressen, die beim Antworten verwendet werden sollen.The email addresses to use when replying.
sendersender Empfängerrecipient Das Konto, das tatsächlich verwendet wird, um die Nachricht zu generieren.The account that is actually used to generate the message.
sentDateTimesentDateTime DateTimeOffsetDateTimeOffset Das Datum und die Uhrzeit, zu der die Nachricht gesendet wurde.The date and time the message was sent.
Betreffsubject StringString Der Betreff der Nachricht.The subject of the message.
toRecipientstoRecipients recipient collectionrecipient collection Die An:-Empfänger der Nachricht.The To: recipients for the message.
uniqueBodyuniqueBody itemBodyitemBody Der Teil des Textkörpers der Nachricht, der für die aktuelle Nachricht eindeutig ist.The part of the body of the message that is unique to the current message.
webLinkwebLink StringString Die URL zum Öffnen der Nachricht in Outlook Web App.The URL to open the message in Outlook Web App.

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, zeigt der Browser die Nachricht in Outlook Web App im Prüffensterbereich an.You can append an ispopout argument to the end of the URL to change how the message is displayed. If ispopout is not present or if it is set to 1, then the message is shown in a popout window. If ispopout is set to 0, then the browser will show the message in the Outlook Web App review pane.

Die Nachricht wird im Browser geöffnet, wenn Sie über Outlook Web App bei Ihrem Postfach angemeldet sind. Sie werden aufgefordert, sich anzumelden, wenn Sie noch nicht beim Browser angemeldet sind.The message will open in the browser if you are logged in to your mailbox via Outlook Web App. You will be prompted to login if you are not already logged in with the browser.

Auf diese URL kann von einem iFrame aus zugegriffen werden.This URL can be accessed from within an iFrame.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
attachmentsattachments attachment-Sammlungattachment collection Schreibgeschützt. Lässt Nullwerte zu.Read-only. Nullable.
eventevent eventevent 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.The event associated with the event message. The assumption for attendees or room resources is that the Calendar Attendant is set to automatically update the calendar with an event when meeting request event messages arrive. Navigation property. Read-only.
Erweiterungenextensions extension-Sammlungextension collection Die Sammlung der für das Ereignis definierten offenen Erweiterungen. Schreibgeschützt. Lässt NULL-Werte zu.The collection of open extensions defined for the eventMessage. Read-only. Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties multiValueLegacyExtendedProperty-SammlungmultiValueLegacyExtendedProperty collection Die Sammlung der für die eventMessage definierten mehrwertigen erweiterten Eigenschaften. Schreibgeschützt. Lässt Nullwerte zu.The collection of multi-value extended properties defined for the eventMessage. Read-only. Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties singleValueLegacyExtendedProperty-SammlungsingleValueLegacyExtendedProperty collection Die Sammlung der für die eventMessage definierten einwertigen erweiterten Eigenschaften. Schreibgeschützt. Lässt Nullwerte zu.The collection of single-value extended properties defined for the eventMessage. Read-only. Nullable.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.Here is a JSON representation of the resource

{
  "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",
  "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",
  "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"
}