eventMessageRequest-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 im Postfach eines eingeladenen Benutzers darstellt.
Die eventMessageRequest-Entität wird von eventMessage abgeleitet.
Um auf die Besprechungsanfrage zu antworten, verwenden Sie zunächst die Ereignisnavigationseigenschaft , um auf das entsprechende Ereignis zuzugreifen, wie in diesem Beispiel gezeigt. Akzeptieren, mit Vorbehalt annehmen oder ablehnen Sie dann das Ereignis, das der eventMessageRequest zugeordnet ist.
JSON-Darstellung
Die folgende JSON-Darstellung zeigt den Ressourcentyp.
{
"allowNewTimeProposals": "Boolean",
"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": "String (timestamp)",
"endDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
"from": {"@odata.type": "microsoft.graph.recipient"},
"hasAttachments": true,
"id": "string (identifier)",
"importance": "String",
"inferenceClassification": "String",
"isDelegated": true,
"isDeliveryReceiptRequested": true,
"isDraft": true,
"isOutOfDate": "Boolean",
"isRead": true,
"isReadReceiptRequested": true,
"lastModifiedDateTime": "String (timestamp)",
"location": {"@odata.type": "microsoft.graph.location"},
"meetingMessageType": "microsoft.graph.meetingMessageType",
"meetingRequestType": "microsoft.graph.meetingRequestType ",
"mentionsPreview": {"@odata.type": "microsoft.graph.mentionsPreview"},
"parentFolderId": "string",
"previousEndDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
"previousLocation": {"@odata.type": "microsoft.graph.location"},
"previousStartDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
"receivedDateTime": "String (timestamp)",
"recurrence": {"@odata.type": "microsoft.graph.patternedRecurrence"},
"replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
"responseRequested": "Boolean",
"sender": {"@odata.type": "microsoft.graph.recipient"},
"sentDateTime": "String (timestamp)",
"startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
"subject": "string",
"toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
"type": "string",
"uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
"webLink": "string"
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| allowNewTimeProposals | Boolescher Wert |
True wenn der Besprechungsorganisator eingeladenen Personen die Möglichkeit bietet, beim Antworten eine neue Uhrzeit vorzuschlagen, andernfalls false. Optional. Der Standardwert lautet true. |
| bccRecipients | recipient collection | Die Bcc:-Empfänger der Nachricht. |
| body | itemBody | Der Text der Nachricht. |
| bodyPreview | String | Die ersten 255 Zeichen des Nachrichtentexts. |
| 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 | Der Index der Unterhaltung, zu der die E-Mail gehört. |
| createdDateTime | DateTimeOffset | Das Datum und die Uhrzeit, zu der die Nachricht erstellt wurde. |
| endDateTime | DateTimeTimeZone | Die Endzeit der angeforderten Besprechung. |
| 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 | Schreibgeschützt. |
| Wichtigkeit | String | Wichtigkeit der Nachricht: Low, Normal, High. |
| inferenceClassification | String | Mögliche Werte: Focused, Other. |
| isDelegated | Boolesch | True, wenn diese Antwort einer 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 | Ort | Der Ort der angeforderten Besprechung. |
| meetingMessageType | String | Der Typ der Ereignisnachricht: none, meetingRequest, meetingCancelled, meetingAccepted, meetingTentativelyAccepted, meetingDeclined. |
| meetingRequestType | Zeichenfolge | Der Typ der Besprechungsanfrage. Mögliche Werte sind: none, newMeetingRequest, fullUpdate, informationalUpdate, silentUpdate, outdatedund principalWantsCopy. |
| 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. |
| previousEndDateTime | DateTimeTimeZone | Wenn das Besprechungsupdate die Endzeit der Besprechung ändert, gibt diese Eigenschaft die Endzeit der vorherigen Besprechung an. |
| previousLocation | Location | Wenn das Besprechungsupdate den Besprechungsort ändert, gibt diese Eigenschaft den vorherigen Besprechungsort an. |
| previousStartDateTime | DateTimeTimeZone | Wenn die Besprechungsaktualisierung die Startzeit der Besprechung ändert, gibt diese Eigenschaft die vorherige Startzeit der Besprechung an. |
| 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. |
| responseRequested | Boolesch | Legen Sie diesen Wert auf true fest, wenn der Absender möchte, dass der eingeladene Benutzer eine Antwort an die angeforderte Besprechung sendet. |
| 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 ü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. |
| 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 |
|---|---|---|
| Ereignisnachricht abrufen | eventMessage | Liest die Eigenschaften und Beziehungen eines eventMessage-Objekts. |
| Ereignisnachricht aktualisieren | eventMessage | Aktualisiert das eventMessage-Objekt. |
| Ereignisnachricht löschen | Keine | 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 für die Antwort | message | Erstellt einen Entwurf der Antwortnachricht. Sie können den Entwurf dann aktualisieren oder senden. |
| Erstellen eines Entwurfs für alle Antworten | message | 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 | message | 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. |
| 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. |
| Erstellen einer mehrwertigen Eigenschaft | eventMessage | Erstellt eine oder mehrere mehrwertige erweiterte Eigenschaften in einer neuen oder vorhandenen eventMessage. |
| Abrufen einer mehrwertigen Eigenschaft | eventMessage | Ruft unter Verwendung von $expand eine eventMessage ab, die eine mehrwertige erweiterte Eigenschaft enthält. |