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 eine Besprechungsanfrage, -absage oder -antwort darstellt. Kann einer der folgenden Werte sein: Akzeptanz, mit Vorbehalt oder Ablehnung.
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, kommt 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 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-Instanz im Postfach eines eingeladenen Benutzers gefunden werden, weil ein Ereignisorganisator eine Besprechung abgesagt hat, oder im Postfach des Organisators, weil ein eingeladener Benutzer 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 veranschaulicht 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 zum Generieren der Nachricht verwendet wird. 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 finden Sie unter Festlegen der Eigenschaften from und sender. |
| 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 ist oder auf 1 festgelegt ist, wird die Meldung in einem Popupfenster angezeigt. Wenn ispopout auf 0 festgelegt ist, zeigt der Browser die Meldung im Überprüfungsbereich von Outlook im Web 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 mit dem Browser angemeldet sind. Auf diese URL kann nicht innerhalb eines iFrames 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 messages diese Eigenschaft nur zurück, wenn Sie auf die -Eigenschaft anwenden $expand . |
| 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 |
|---|---|---|
| Get | eventMessage | Liest die Eigenschaften und Beziehungen eines eventMessage-Objekts. |
| Aktualisieren | eventMessage | Aktualisiert das eventMessage-Objekt. |
| Löschen | Keiner | Löscht das eventMessage-Objekt. |
| Nachricht kopieren | Nachricht | Kopiert eine Nachricht in einen Ordner. |
| Erstellen eines Entwurfs zum Weiterleiten einer Nachricht | Nachricht | Erstellt einen Entwurf der Weiterleitungsnachricht. Sie können den Entwurf dann aktualisieren oder senden. |
| Erstellen eines Entwurfs zum Beantworten einer Nachricht | Nachricht | Erstellt einen Entwurf der Antwortnachricht. Sie können den Entwurf dann aktualisieren oder senden. |
| Entwurf für „Allen antworten“ | Nachricht | Erstellt einen Entwurf der „Allen Antworten“-Nachricht. Sie können den Entwurf dann aktualisieren oder senden. |
| Nachricht weiterleiten | Keine | Leitet eine Nachricht weiter. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert. |
| Nachricht verschieben | Nachricht | Verschiebt eine Nachricht in einen Ordner. Dadurch wird eine neue Kopie der Nachricht im Zielordner erstellt. |
| Antworten auf eine Nachricht | Keine | Antwortet auf eine Nachricht des Absenders. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert. |
| Allen antworten auf Nachricht | Keine | Sendet eine Antwort an alle Empfänger einer E-Mail. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert. |
| Nachrichtenentwurf senden | Keine | Sendet einen zuvor erstellten Nachrichtenentwurf. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert. |
| Rückrufnachricht | message | Rufen Sie eine Nachricht im Ordner "Gesendete Elemente" des angegebenen Benutzers zurück. |
| Unsubscribe | Keine | Sendet eine Nachricht unter Verwendung der Daten und der Adresse, die im ersten mailto-Befehl im List-Unsubscribe-Header angegeben wurden. |
| Endgültig löschen | Keine | Löschen Sie eine Ereignisnachricht endgültig, und platzieren Sie sie im Ordner "Löschvorgänge" im Ordner "Wiederherstellbare Elemente" im Postfach des Benutzers. |
| 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 Eigenschaft erstellen | eventMessage | Erstellt eine oder mehrere einwertige erweiterte Eigenschaften in einer neuen oder vorhandenen eventMessage. |
| Einwertige Eigenschaft abrufen | eventMessage | Ruft mithilfe von $expand oder $filter eventMessages mit einer einwertigen erweiterten Eigenschaft ab. |
| Erweiterte mehrwertige Eigenschaft erstellen | eventMessage | Erstellt eine oder mehrere mehrwertige erweiterte Eigenschaften in einer neuen oder vorhandenen eventMessage. |
| Erweiterte mehrwertige Eigenschaft abrufen | eventMessage | Ruft unter Verwendung von $expand eine eventMessage ab, die eine mehrwertige erweiterte Eigenschaft enthält. |