chatMessage-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

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.
Abonnement für neue Kanalnachrichten erstellen	Abonnement	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.
Nachricht im Kanal löschen	chatMessage	Löschen Sie die Nachricht in einem Kanal.
Rückgängigmachen des Löschens einer Nachricht im Kanal	chatMessage	Wiederherstellen der Nachricht in einem Kanal.
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.
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.
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.
Abonnement für neue Chat-Nachrichten erstellen	Abonnement	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.
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.
Gehostete Inhalte
Alle gehosteten Inhalte auflisten	chatMessageHostedContent-Sammlung	Rufen Sie alle gehosteten Inhalte ab, die einer Nachricht zugeordnet sind.
Gehosteten Inhalt abrufen	chatMessageHostedContent	Ruft gehosteten Inhalt (und seine 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	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.
channelIdentity	channelIdentity	Wenn die Nachricht in einem Kanal gesendet wurde, stellt die Identität des Kanals dar.
chatId	string	Wenn die Nachricht in einem Chat gesendet wurde, stellt die Identität des Chats dar.
createdDateTime	dateTimeOffset	Zeitstempel des Zeitpunkts, an dem die Chatnachricht erstellt wurde.
deletedDateTime	dateTimeOffset	Schreibgeschützt. Zeitstempel, mit dem die Chatnachricht gelöscht wurde, oder NULL, wenn nicht gelöscht.
etag	string	Schreibgeschützt. Versionsnummer der Chatnachricht.
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.
von	chatMessageFromIdentitySet	Details des Absenders der Chatnachricht. Kann nur während der Migration festgelegt werden.
id	String	Schreibgeschützt. Eindeutige ID der Nachricht.
Wichtigkeit	string	Die Wichtigkeit der Chatnachricht. Die möglichen Werte sind: normal, high, urgent.
lastEditedDateTime	dateTimeOffset	Schreibgeschützt. Zeitstempel, wenn Änderungen an der Chatnachricht vorgenommen wurden. Löst ein "Bearbeitet"-Kennzeichen in der Teams-Benutzeroberfläche aus. Wenn keine Änderungen vorgenommen werden, ist nullder Wert .
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.
Gebietsschema	string	Gebietsschema der vom Client festgelegten Chatnachricht. 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 und Tag.
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 einer Richtlinienverletzung, die 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. DIE ID der übergeordneten Chatnachricht oder der 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 Kanal-Chatnachrichten, nicht für Chatnachrichten in einem Chat.
webUrl	string	Schreibgeschützt. Link zu der Nachricht in Microsoft Teams.

Beziehungen

Beziehung	Typ	Beschreibung
Antworten	chatMessage	Antworten auf eine angegebene Nachricht. Unterstützt $expand Kanalnachrichten.
hostedContents	chatMessageHostedContent	Inhalt in einer von Microsoft Teams gehosteten Nachricht , 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"}],
  "onBehalfOf": {"@odata.type": "microsoft.graph.chatMessageFromIdentitySet"},
  "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"
  }
}