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
Nachrichten im Kanal auflisten	chatMessage-Auflistung	Liste aller Stammnachrichten in einem Kanal.
Delta von Nachrichten im Kanal abrufen	chatMessage	Abrufen von inkrementellen Nachrichten in einem Kanal.
Erstellen eines Abonnements für neue Kanalnachrichten	subscription	Lauschen Sie 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	chatMessage	Aktualisieren Sie die policyViolation-Eigenschaft einer Chatnachricht.
Antworten auf Kanalnachrichten
Antworten auf Nachricht auflisten	chatMessage-Auflistung	Liste aller Antworten auf eine Chatnachricht im Kanal.
Antwortnachricht im Kanal abrufen	chatMessage	Rufen Sie eine einzelne Antwortnachricht in einem Kanal ab.
Antworten auf eine Nachricht im Kanal	chatMessage	Antworten auf eine vorhandene Chatnachricht in einem Kanal.
Antwortnachricht aktualisieren	chatMessage	Aktualisieren Sie die policyViolation-Eigenschaft einer Chatnachricht.
Chat-Nachrichten
Nachrichten im Chat auflisten	chatMessage	Chatnachrichten in einem Chat auflisten.
Nachricht in Chat abrufen	chatMessage	Rufen Sie eine einzelne Chatnachricht in einem Chat ab.
Erhalten von Nachrichten in allen Chats für Benutzer	Chatsammlung	Abrufen von Nachrichten aus allen Chats, an denen ein Benutzer teil nimmt, einschließlich 1:1-Chats, Gruppenchats und Besprechungschats.
Alle Kanalnachrichten abrufen	Kanal-Sammlung	Abrufen aller Nachrichten aus allen Kanälen, an denen ein Benutzer beteiligt ist.
Erstellen eines Abonnements für neue Chatnachrichten	subscription	Lauschen Sie auf neue, bearbeitete und gelöschte Chatnachrichten und Reaktionen darauf.
Nachricht im Chat senden	chatMessage	Senden einer Chatnachricht in einer vorhandenen 1:1- oder Gruppenchatunterhaltung.
Nachricht im Chat aktualisieren	chatMessage	Aktualisieren Sie die policyViolation-Eigenschaft einer Chatnachricht.
Gehostete Inhalte
Auflisten aller gehosteten Inhalte	chatMessageHostedContent-Sammlung	Rufen Sie alle gehosteten Inhalte ab, die einer Nachricht zugeordnet sind.
Abrufen gehosteter Inhalte	chatMessageHostedContent	Ruft gehosteten Inhalt (und seine Bytes) für eine Nachricht ab.

Eigenschaften

Eigenschaft	Typ	Beschreibung
id	Zeichenfolge	Schreibgeschützt. Eindeutige ID der Nachricht.
replyToId	string	Schreibgeschützt. DIE ID der übergeordneten Chatnachricht oder der Stammchatnachricht des Threads. (Gilt nur für Chatnachrichten in Kanälen, nicht für Chats.)
Von	chatMessageFromIdentitySet	Details des Absenders der Chatnachricht. Kann nur während der Migration festgelegt werden.
etag	string	Schreibgeschützt. Versionsnummer der Chatnachricht.
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.
createdDateTime	dateTimeOffset	Zeitstempel des Zeitpunkts, an dem die Chatnachricht erstellt wurde.
lastModifiedDateTime	dateTimeOffset	Schreibgeschützt. Zeitstempel, wenn die Chatnachricht erstellt (anfängliche Einstellung) oder geändert wird, einschließlich, wenn eine Reaktion hinzugefügt oder entfernt wird.
lastEditedDateTime	dateTimeOffset	Schreibgeschützt. Zeitstempel, wenn Änderungen an der Chatnachricht vorgenommen wurden. Löst ein "Bearbeitet"-Kennzeichen in der benutzeroberfläche Teams aus. Wenn keine Änderungen vorgenommen werden, ist nullder Wert .
deletedDateTime	dateTimeOffset	Schreibgeschützt. Zeitstempel, mit dem die Chatnachricht gelöscht wurde, oder NULL, wenn nicht gelöscht.
subject	Zeichenfolge	Der Betreff der Chatnachricht im Klartext.
body	itemBody	Nur-Text/HTML-Darstellung des Inhalts der Chatnachricht. Die Darstellung ist durch den ContentType im Text angegeben. Der Inhalt befindet sich immer in HTML, wenn die Chatnachricht eine chatMessageMention enthält.
Zusammenfassung	Zeichenfolge	Zusammenfassungstext der Chatnachricht, der für Pushbenachrichtigungen und Zusammenfassungsansichten oder Fallbackansichten verwendet werden kann. Gilt nur für Kanal-Chatnachrichten, nicht für Chatnachrichten in einem Chat.
Anlagen	chatMessageAttachment-Sammlung	Verweise auf angefügte Objekte wie Dateien, Registerkarten, Besprechungen usw.
Erwähnungen	chatMessageMention-Sammlung	Liste der in der Chatnachricht erwähnten Entitäten. Unterstützte Entitäten sind: Benutzer, Bot, Team und Kanal.
Wichtigkeit	Zeichenfolge	Die Wichtigkeit der Chatnachricht. Die möglichen Werte sind: normal, high, urgent.
Reaktionen	chatMessageReaction-Sammlung	Reaktionen auf diese Chatnachricht (z. B. "Gefällt mir").
Gebietsschema	Zeichenfolge	Gebietsschema der vom Client festgelegten Chatnachricht. Stets auf en-us festgelegt.
policyViolation	chatMessagePolicyViolation	Definiert die Eigenschaften einer Richtlinienverletzung, die von einer DLP-Anwendung (Data Loss Prevention, Verhinderung von Datenverlust) festgelegt wird.
chatId	Zeichenfolge	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.
webUrl	string	Schreibgeschützt. Link zur Nachricht in Microsoft Teams.
eventDetail	eventMessageDetail	Schreibgeschützt. Wenn vorhanden, werden Details zu einem Ereignis dargestellt, 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.

Beziehungen

Beziehung	Typ	Beschreibung
Antworten	chatMessage	Antworten auf eine angegebene Nachricht. Unterstützt $expand Kanalnachrichten.
hostedContents	chatMessageHostedContent	Inhalt in einer Nachricht, die von Microsoft Teams gehostet wird, z. B. Bilder oder Codeausschnitte.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "id": "string (identifier)",
  "replyToId": "string (identifier)",
  "from": {"@odata.type": "microsoft.graph.chatMessageFromIdentitySet"},
  "etag": "string",
  "messageType": "string",
  "createdDateTime": "string (timestamp)",
  "lastModifiedDateTime": "string (timestamp)",
  "lastEditedDateTime": "string (timestamp)",
  "deletedDateTime": "string (timestamp)",
  "subject": "string",
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "summary": "string",
  "attachments": [{"@odata.type": "microsoft.graph.chatMessageAttachment"}],
  "mentions": [{"@odata.type": "microsoft.graph.chatMessageMention"}],
  "importance": "string",
  "reactions": [{"@odata.type": "microsoft.graph.chatMessageReaction"}],
  "locale": "string",
  "policyViolation": {"@odata.type": "microsoft.graph.chatMessagePolicyViolation"},
  "chatId": "string",
  "channelIdentity": {"@odata.type": "microsoft.graph.channelIdentity"},
  "webUrl": "string",
  "eventDetail": {
    "@odata.type": "microsoft.graph.eventMessageDetail"
  }
}