chatMessage-Ressourcentyp
Namespace: microsoft.graph
Stellt eine einzelne Chatnachricht innerhalb eines Kanals oder eines Chats dar. Die Nachricht kann eine Stammnachricht oder Teil eines Threads sein, die bzw. der von der replyToId-Eigenschaft in der Nachricht definiert wird.
Hinweis: Diese Ressource unterstützt das Abonnieren von Änderungen (Erstellen, Aktualisieren und Löschen) mithilfe von Änderungsbenachrichtigungen. Auf diese Weise können Anrufer in Echtzeit abonnieren und Änderungen abrufen. Details finden Sie unter Abrufen von Benachrichtigungen für Nachrichten.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Kanalnachrichten | ||
| Auflisten von Nachrichten im Kanal | chatMessage-Auflistung | Liste aller Stammnachrichten in einem Kanal. |
| Abonnement für neue Kanalnachrichten erstellen | Abonnement | Lauschen auf neue, bearbeitete und gelöschte Nachrichten und Reaktionen darauf. |
| Nachricht im Kanal abrufen | chatMessage | Ruft eine einzelne Stammnachricht in einem Kanal ab. |
| Nachricht im Kanal senden | chatMessage | Erstellen Sie eine neue Stammnachricht in einem Kanal. |
| Nachricht im Kanal aktualisieren | Keine | Aktualisieren sie die policyViolation-Eigenschaft einer Chatnachricht. |
| Nachricht im Kanal löschen | Keine | Löschen Sie die Nachricht in einem Kanal. |
| Rückgängigmachen des Löschens einer Nachricht im Kanal | Keine | Wiederherstellen der Nachricht in einem Kanal. |
| Festlegen der Reaktion auf eine Nachricht im Kanal | Keine | Legen Sie die Reaktion auf eine Nachricht in einem Kanal fest. |
| Nicht festgelegte Reaktion auf eine Nachricht im Kanal | Keine | Nicht festgelegte Reaktion auf eine Nachricht in einem Kanal. |
| Antworten auf Kanalnachrichten | ||
| Antworten in einer Nachricht auflisten | chatMessage-Auflistung | Liste aller Antworten auf eine Chatnachricht im Kanal. |
| Antwortnachricht im Kanal abrufen | chatMessage | Ruft eine einzelne Antwortnachricht in einem Kanal ab. |
| Auf eine Nachricht im Kanal antworten | chatMessage | Antworten auf eine vorhandene Chatnachricht in einem Kanal. |
| Antwortnachricht aktualisieren | chatMessage | Aktualisieren sie die policyViolation-Eigenschaft einer Chatnachricht. |
| Antwortnachricht im Kanal löschen | chatMessage | Löschen Sie die einzelne Antwortnachricht in einem Kanal. |
| Rückgängigmachen des Löschens einer Antwortnachricht im Kanal | chatMessage | Wiederherstellen der einzelnen Antwortnachricht in einem Kanal. |
| Festlegen der Reaktion auf eine Nachricht im Kanal | Keine | Legen Sie die Reaktion auf eine Nachricht in einem Kanal fest. |
| Nicht festgelegte Reaktion auf eine Nachricht im Kanal | Keine | Nicht festgelegte Reaktion auf eine Nachricht in einem Kanal. |
| Chat-Nachrichten | ||
| Nachrichten im Chat auflisten | chatMessage | Auflisten von Chatnachrichten in einem Chat. |
| Nachricht in Chat abrufen | chatMessage | Abrufen einer einzelnen Chatnachricht in einem Chat. |
| Erhalten von Nachrichten in allen Chats für Benutzer | Chatsammlung | Abrufen von Nachrichten aus allen Chats, an denen ein Benutzer teilnimmt, einschließlich 1:1-Chats, Gruppenchats und Besprechungschats. |
| Abrufen von Delta-Chatnachrichten für Benutzer | chatMessage-Auflistung | Rufen Sie die Liste der Nachrichten aus allen Chats ab, an denen ein Benutzer teilnimmt, einschließlich Einzelchats, Gruppenchats und Besprechungschats. |
| Alle Kanalnachrichten abrufen | Kanal-Sammlung | Abrufen aller Nachrichten aus allen Kanälen, an denen ein Benutzer beteiligt ist. |
| Abonnement für neue Chat-Nachrichten erstellen | subscription | Lauschen auf neue, bearbeitete und gelöschte Chatnachrichten und Reaktionen darauf. |
| Nachricht im Chat senden | chatMessage | Senden Sie eine Chatnachricht in einer vorhandenen 1:1- oder Gruppenchatunterhaltung. |
| Nachricht im Chat aktualisieren | chatMessage | Aktualisieren sie die policyViolation-Eigenschaft einer Chatnachricht. |
| Nachricht im Chat löschen | chatMessage | Löschen Sie die Nachricht eines Chats. |
| Rückgängigmachen des Löschens einer Nachricht im Chat | chatMessage | Wiederherstellen der Nachricht in einem Chat |
| Festlegen der Reaktion auf eine Nachricht im Kanal | Keine | Legen Sie die Reaktion auf eine Nachricht in einem Kanal fest. |
| Nicht festgelegte Reaktion auf eine Nachricht im Kanal | Keine | Nicht festgelegte Reaktion auf eine Nachricht in einem Kanal. |
| Gehostete Inhalte | ||
| Alle gehosteten Inhalte auflisten | chatMessageHostedContent-Sammlung | Ruft alle gehosteten Inhalte ab, die einer Nachricht zugeordnet sind. |
| Gehosteten Inhalt abrufen | chatMessageHostedContent | Rufen Sie gehostete Inhalte (und deren Bytes) für eine Nachricht ab. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| Anlagen | chatMessageAttachment-Sammlung | Verweise auf angefügte Objekte wie Dateien, Registerkarten, Besprechungen usw. |
| body | itemBody | Klartext-/HTML-Darstellung des Inhalts der Chatnachricht. Die Darstellung ist durch den ContentType im Text angegeben. Der Inhalt befindet sich immer im HTML-Code, wenn die Chatnachricht eine chatMessageMention enthält. |
| chatId | string | Wenn die Nachricht in einem Chat gesendet wurde, stellt die Identität des Chats dar. |
| channelIdentity | channelIdentity | Wenn die Nachricht in einem Kanal gesendet wurde, stellt die Identität des Kanals dar. |
| createdDateTime | dateTimeOffset | Zeitstempel des Erstellungszeitpunkts der Chatnachricht. |
| deletedDateTime | dateTimeOffset | Schreibgeschützt. Zeitstempel, zu dem die Chatnachricht gelöscht wurde, oder NULL, wenn nicht gelöscht. |
| etag | string | Schreibgeschützt. Versionsnummer der Chatnachricht. |
| eventDetail | eventMessageDetail | Schreibgeschützt. Falls vorhanden, stellt Details zu einem Ereignis dar, das in einem Chat, einem Kanal oder einem Team aufgetreten ist, z. B. das Hinzufügen neuer Mitglieder. Bei Ereignismeldungen wird die messageType-Eigenschaft auf systemEventMessagefestgelegt. |
| von | chatMessageFromIdentitySet | Details zum Absender der Chatnachricht. Kann nur während der Migration festgelegt werden. |
| id | Zeichenfolge | Schreibgeschützt. Eindeutige ID der Nachricht. IDs sind innerhalb eines Chats/Kanals/einer Antwort auf Nachricht eindeutig, können aber in anderen Chats/Kanälen/Antworten auf Nachrichten dupliziert werden. |
| Wichtigkeit | string | Die Wichtigkeit der Chatnachricht. Die möglichen Werte sind: normal, high, urgent. |
| lastModifiedDateTime | dateTimeOffset | Schreibgeschützt. Zeitstempel, wenn die Chatnachricht erstellt (Anfangseinstellung) oder geändert wird, einschließlich des Hinzufügens oder Entfernens einer Reaktion. |
| lastEditedDateTime | dateTimeOffset | Schreibgeschützt. Zeitstempel, zu dem Änderungen an der Chatnachricht vorgenommen wurden. Löst ein Flag "Bearbeitet" in der Teams-Benutzeroberfläche aus. Wenn keine Änderungen vorgenommen werden, ist nullder Wert . |
| Gebietsschema | Zeichenfolge | Gebietsschema der vom Client festgelegten Chatnachricht. Stets auf en-us festgelegt. |
| Erwähnungen | chatMessageMention-Sammlung | Liste der Entitäten, die in der Chatnachricht erwähnt werden. Unterstützte Entitäten sind: Benutzer, Bot, Team und Kanal. |
| messageHistory | chatMessageHistoryItem-Auflistung | Liste des Aktivitätsverlaufs eines Nachrichtenelements, einschließlich Änderungszeit und Aktionen wie ReaktionAdded, ReaktionRemoved oder Reaktionsänderungen für die Nachricht. |
| messageType | chatMessageType | Der Typ der Chatnachricht. Mögliche Werte sind: message, chatEvent, typing, unknownFutureValue, systemEventMessage. Beachten Sie, dass Sie den Prefer: include-unknown-enum-members Anforderungsheader verwenden müssen, um den folgenden Wert in dieser optionierbaren Enumerationabzurufen: systemEventMessage. |
| policyViolation | chatMessagePolicyViolation | Definiert die Eigenschaften eines Richtlinienverstoßes, der von einer DLP-Anwendung (Data Loss Prevention, Verhinderung von Datenverlust) festgelegt wird. |
| Reaktionen | chatMessageReaction-Sammlung | Reaktionen auf diese Chatnachricht (z. B. "Gefällt mir"). |
| replyToId | string | Schreibgeschützt. ID der übergeordneten Chatnachricht oder Stammchatnachricht des Threads. (Gilt nur für Chatnachrichten in Kanälen, nicht für Chats.) |
| subject | string | Der Betreff der Chatnachricht im Klartext. |
| Zusammenfassung | Zeichenfolge | Zusammenfassungstext der Chatnachricht, der für Pushbenachrichtigungen und Zusammenfassungsansichten oder Fallbackansichten verwendet werden kann. Gilt nur für Kanalchatnachrichten, nicht für Chatnachrichten in einem Chat. |
| webUrl | string | Schreibgeschützt. Link zur Nachricht in Microsoft Teams. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| hostedContents | chatMessageHostedContent-Sammlung | Inhalte in einer von Microsoft Teams gehosteten Nachricht, z. B. Bilder oder Codeausschnitte. |
| Beantwortungen | chatMessage-Auflistung | Antworten auf eine angegebene Nachricht. Unterstützt $expand Kanalnachrichten. |
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"attachments": [{"@odata.type": "microsoft.graph.chatMessageAttachment"}],
"body": {"@odata.type": "microsoft.graph.itemBody"},
"channelIdentity": {"@odata.type": "microsoft.graph.channelIdentity"},
"chatId": "String",
"createdDateTime": "String (timestamp)",
"deletedDateTime": "String (timestamp)",
"etag": "String",
"eventDetail": {"@odata.type": "microsoft.graph.eventMessageDetail"},
"from": {"@odata.type": "microsoft.graph.chatMessageFromIdentitySet"},
"id": "String (identifier)",
"importance": "String",
"lastEditedDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"locale": "String",
"mentions": [{"@odata.type": "microsoft.graph.chatMessageMention"}],
"messageHistory": [{"@odata.type": "microsoft.graph.chatMessageHistoryItem"}],
"messageType": "String",
"policyViolation": {"@odata.type": "microsoft.graph.chatMessagePolicyViolation"},
"reactions": [{"@odata.type": "microsoft.graph.chatMessageReaction"}],
"replyToId": "String (identifier)",
"subject": "String",
"summary": "String",
"webUrl": "String"
}