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.

Die targetedChatMessage-Ressource ist eine spezielle Art von Chatnachrichten, die nur für angegebene Empfänger sichtbar ist. Weitere Informationen finden Sie unter targetedChatMessage.

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	Hören Sie auf neue, bearbeitete und gelöschte Nachrichten und Reaktionen darauf.
Nachricht im Kanal abrufen	chatMessage	Abrufen einer einzelnen Stammnachricht in einem Kanal.
Nachricht im Kanal senden	chatMessage	Erstellen Sie eine neue Stammnachricht in einem Kanal.
Nachricht im Kanal aktualisieren	Keine	Aktualisieren der 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	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	Abrufen einer einzelnen Antwortnachricht in einem Kanal.
Auf eine Nachricht im Kanal antworten	chatMessage	Antworten auf eine vorhandene Chatnachricht in einem Kanal.
Antwortnachricht aktualisieren	chatMessage	Aktualisieren der 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	Festgelegte Reaktion auf eine Antwortnachricht in einem Kanal.
Chat-Nachrichten
Nachrichten im Chat auflisten	chatMessage	Chatnachrichten in einem Chat auflisten.
Nachricht in Chat abrufen	chatMessage	Abrufen einer einzelnen Chatnachricht in einem Chat.
Erhalten von Nachrichten in allen Chats für Benutzer	Sammlung von Chats	Abrufen von Nachrichten aus allen Chats, in denen ein Benutzer Teilnehmer ist, einschließlich 1:1-Chats, Gruppenchats und Besprechungschats.
Delta-Chatnachrichten für Benutzer abrufen	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	Abonnement	Hören Sie 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 der Eigenschaften einer Chatnachricht.
Nachricht im Chat löschen	chatMessage	Löschen der Nachricht eines Chats.
Rückgängigmachen des Löschens einer Nachricht im Chat	chatMessage	Die Nachricht in einem Chat wiederherstellen.
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	Festgelegte Reaktion auf eine Nachricht in einem Chat.
Nachricht an Chat weiterleiten	forwardToChatResult-Sammlung	Weiterleiten einer Chatnachricht, einer Kanalnachricht oder einer Antwort einer Kanalnachricht an einen Chat.
Mit Zitat antworten	chatMessage	Antworten Sie mit einem Zitat auf eine einzelne Chat-Nachricht oder auf mehrere Chat-Nachrichten in einem Chat.
Gehostete Inhalte
Alle gehosteten Inhalte auflisten	chatMessageHostedContent-Sammlung	Abrufen aller gehosteten Inhalte, die einer Nachricht zugeordnet sind.
Gehosteten Inhalt abrufen	chatMessageHostedContent	Abrufen von gehosteten Inhalten (und deren Bytes) für eine Nachricht.

Eigenschaften

Eigenschaft	Typ	Beschreibung
Anlagen	chatMessageAttachment-Sammlung	Verweise auf angefügte Objekte wie Dateien, Registerkarten, Besprechungen usw.
body	chatMessageBody	Klartext-/HTML-/Markdown-Darstellung des Inhalts der Chatnachricht. Die Darstellung wird durch die messageBodyContentType-Eigenschaft (oder veraltete contentType-Eigenschaft) innerhalb des Textkörpers angegeben. Der Inhalt ist immer im HTML-Format, wenn die Chatnachricht eine chatMessageMention enthält.
channelIdentity	channelIdentity	Wenn die Nachricht in einem Kanal gesendet wurde, stellt dies die Identität des Kanals dar.
chatId	string	Wenn die Nachricht in einem Chat gesendet wurde, stellt dies die Identität des Chats dar.
createdDateTime	dateTimeOffset	Zeitstempel der Erstellung der Chatnachricht.
deletedDateTime	dateTimeOffset	Schreibgeschützt. Zeitstempel, zu dem die Chatnachricht gelöscht wurde, oder null, wenn sie nicht gelöscht wurde.
etag	string	Schreibgeschützt. Versionsnummer der Chatnachricht.
eventDetail	eventMessageDetail	Schreibgeschützt. Falls vorhanden, stellt es Details zu einem Ereignis dar, das in einem Chat, einem Kanal oder einem Team stattgefunden hat, z. B. das Hinzufügen neuer Mitglieder. Für Ereignisnachrichten 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/Antwortnachrichten dupliziert werden.
Wichtigkeit	chatMessageImportance	Die Wichtigkeit der Nachricht. Mögliche Werte sind: normal, high, urgent, unknownFutureValue.
lastEditedDateTime	dateTimeOffset	Schreibgeschützt. Zeitstempel, als Änderungen an der Chatnachricht vorgenommen wurden. Löst eine "bearbeitete" Kennzeichnung in der Teams-Benutzeroberfläche aus. Wenn keine Änderungen vorgenommen werden, lautet 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 Chatnachricht, festgelegt vom Client. Stets auf en-us festgelegt.
Erwähnungen	chatMessageMention-Sammlung	Liste der in der Chatnachricht erwähnten Entitäten. 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 reactionAdded, reactionRemoved oder Reaktionsänderungen an der Nachricht.
messageType	chatMessageType	Der Typ der Chatnachricht. Mögliche Werte sind: message, chatEvent, typing, unknownFutureValue, systemEventMessage. Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Elemente in dieser entwicklungsfähigen Aufzählung abzurufen: systemEventMessage.
onBehalfOf	chatMessageFromIdentitySet	Benutzerzuordnung der Nachricht, wenn ein Bot eine Nachricht im Namen eines Benutzers sendet.
policyViolation	chatMessagePolicyViolation	Definiert die Eigenschaften einer Richtlinienverletzung, die von einer Anwendung zur Verhinderung von Datenverlust (Data Loss Prevention, DLP) festgelegt wurde.
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 in 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 Kanal-Chat-Nachrichten, nicht für Chat-Nachrichten in einem Chat.
webUrl	string	Schreibgeschützt. Link zur Nachricht in Microsoft Teams.

Beziehungen

Beziehung	Typ	Beschreibung
Antworten	chatMessage-Auflistung	Antworten für 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.chatMessageBody"},
  "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"
}