chatMessage-Ressourcentyp

Artikel
08/27/2023

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.
Abrufen des Deltas von Nachrichten im Kanal	chatMessage	Abrufen von inkrementellen Nachrichten 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.
Löschen einer Nachricht im Kanal	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.
Kanalnachrichtenantworten
Antworten auf Nachricht auflisten	chatMessage-Auflistung	Liste aller Antworten auf eine Chatnachricht im Kanal.
Abrufen einer Antwortnachricht im Kanal	chatMessage	Ruft eine einzelne Antwortnachricht in einem Kanal ab.
Antworten auf eine Nachricht im Kanal	chatMessage	Antworten auf eine vorhandene Chatnachricht in einem Kanal.
Aktualisieren der Antwortnachricht	chatMessage	Aktualisieren sie die policyViolation-Eigenschaft einer Chatnachricht.
Löschen einer Antwortnachricht im Kanal	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
Auflisten von Nachrichten im Chat	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.
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.
Löschen einer Nachricht im Chat	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 `systemEventMessage`festgelegt.
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`.
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 `null`der 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	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
hostedContents	chatMessageHostedContent-Sammlung	Inhalte in einer von Microsoft Teams gehosteten Nachricht, z. B. Bilder oder Codeausschnitte.
Antworten	chatMessage-Auflistung	Antworten auf eine angegebene Nachricht. Unterstützt `$expand` Kanalnachrichten.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "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"
}