chatMessage-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.
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 | subscription | 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 Eigenschaften 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 Eigenschaften 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. |
| Reaktion auf eine Antwortnachricht im Kanal festlegen | chatMessage | Legen Sie die Reaktion auf eine Antwortnachricht in einem Kanal fest. |
| Festgelegte Reaktion auf eine Antwortnachricht im Kanal aufheben | chatMessage | Nicht festgelegte Reaktion auf eine Antwortnachricht 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 Eigenschaften 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 |
| Reaktion auf eine Nachricht im Chat festlegen | chatMessage | Legen Sie die Reaktion auf eine Nachricht in einem Chat fest. |
| Festgelegte Reaktion auf eine Nachricht im Chat aufheben | chatMessage | Nicht festgelegte Reaktion auf eine Nachricht in einem Chat. |
| 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. |
| channelIdentity | channelIdentity | Wenn die Nachricht in einem Kanal gesendet wurde, stellt die Identität des Kanals dar. |
| chatId | Zeichenfolge | Wenn die Nachricht in einem Chat gesendet wurde, stellt die Identität des Chats 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 | String | 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. |
| 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 . |
| lastModifiedDateTime | dateTimeOffset | Schreibgeschützt. Zeitstempel, wenn die Chatnachricht erstellt (Anfangseinstellung) oder geändert wird, einschließlich des Hinzufügens oder Entfernens einer Reaktion. |
| Gebietsschema | string | 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, Kanal, Chat und Tag. |
| 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. |
| onBehalfOf | chatMessageFromIdentitySet | Benutzerzuordnung der Nachricht, wenn der Bot eine Nachricht im Namen eines Benutzers sendet. |
| 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 | string | 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 |
|---|---|---|
| Beantwortungen | chatMessage-Auflistung | Antworten auf eine angegebene Nachricht. Unterstützt $expand Kanalnachrichten. |
| hostedContents | chatMessageHostedContent-Sammlung | Inhalte in einer von Microsoft Teams gehosteten Nachricht, z. B. Bilder oder Codeausschnitte. |
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",
"onBehalfOf": {"@odata.type": "microsoft.graph.chatMessageFromIdentitySet"},
"policyViolation": {"@odata.type": "microsoft.graph.chatMessagePolicyViolation"},
"reactions": [{"@odata.type": "microsoft.graph.chatMessageReaction"}],
"replyToId": "String (identifier)",
"subject": "String",
"summary": "String",
"webUrl": "String"
}