chatMessage-RessourcentypchatMessage resource type

Namespace: microsoft.graphNamespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported. Verwenden Sie die Versionsauswahl, um zu ermitteln, ob eine API in Version 1.0 verfügbar ist.To determine whether an API is available in v1.0, use the Version selector.

Stellt eine einzelne Chatnachricht innerhalb eines Kanals oder eines Chats dar.Represents an individual chat message within a channel or chat. Die Nachricht kann eine Stammnachricht oder Teil eines Threads sein, die bzw. der von der replyToId-Eigenschaft in der Nachricht definiert wird.The message can be a root message or part of a thread that is defined by the replyToId property in the message.

Hinweis: Diese Ressource unterstützt das Abonnieren von Änderungen (Erstellen, Aktualisieren und Löschen) mithilfe von Änderungsbenachrichtigungen.Note: This resource supports subscribing to changes (create, update, and delete) using change notifications. Auf diese Weise können Anrufer in Echtzeit abonnieren und Änderungen abrufen.This allows callers to subscribe and get changes in real time. Details finden Sie unter Abrufen von Benachrichtigungen für Nachrichten.For details, see Get notifications for messages.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
KanalnachrichtenChannel messages
KanalchatMessage auflistenList channel chatMessage chatMessage-AuflistungchatMessage collection Liste aller Stammchatnachrichten in einem Kanal.List of all root chat messages in a channel.
ChatMessages in einem Kanaldelta erhaltenGet chatMessages in a channel delta chatMessagechatMessage Inkrementelle Chatnachrichten in einem Kanal erhalten.Get incremental chat messages in a channel.
Erstellen eines Abonnements für neue KanalnachrichtenCreate subscription for new channel messages subscriptionsubscription Abhören auf neue und bearbeitete Kanalnachrichten und Reaktionen auf diese.Listen for new and edited channel messages, and reactions to them.
KanalchatMessage erhaltenGet channel chatMessage chatMessagechatMessage Eine einzelne Stammchatnachricht aus einem Kanal erhalten.Get a single root chat message from a channel.
Erstellen von chatMessage in einem Kanal oder ChatCreate chatMessage in a channel or chat chatMessagechatMessage Erstellen Sie eine neue Chatnachricht auf oberster Ebene in einem Kanal.Create a new top-level chat message in a channel.
chatMessage aktualisierenUpdate chatMessage chatMessagechatMessage Aktualisieren der eigenschaft "policyViolation" einer Chatnachricht.Update the policyViolation property of a chat message.
Antworten auf KanalnachrichtenChannel message replies
Auflisten von Antworten auf eine chatMessageList replies to a chatMessage chatMessage-AuflistungchatMessage collection Liste aller Antworten auf eine Chatnachricht im Kanal.List of all replies to a chat message in channel.
Erhalten einer Antwort auf eine chatMessageGet a reply to a chatMessage chatMessagechatMessage Erhalten Sie eine einzelne Antwort auf eine Chatnachricht in einem Kanal.Get a single reply to a chat message in a channel.
Antworten auf eine chatMessage in einem KanalReply to a chatMessage in a channel chatMessagechatMessage Antworten auf eine vorhandene Chatnachricht in einem Kanal.Reply to an existing chat message in a channel.
chatMessage aktualisierenUpdate chatMessage chatMessagechatMessage Aktualisieren der eigenschaft "policyViolation" einer Chatnachricht.Update the policyViolation property of a chat message.
1:1 und Gruppenchatnachrichten1:1 and group chat messages
ChatMessage im Chat erhaltenGet chatMessage in chat chatMessagechatMessage Eine einzelne Chatnachricht in einem Chat erhalten.Get a single chat message in a chat.
Auflisten von chatMessages in einem ChatList chatMessages in a chat chatMessagechatMessage Auflisten von Chatnachrichten in einem 1:1- oder Gruppenchat.List chat messages in a 1:1 or group chat.
Alle Chatnachrichten für Benutzer erhaltenGet all chat messages for user Chatsammlungchat collection Nachrichten von allen Chats, an denen ein Benutzer teilt, einschließlich 1:1-Chats, Gruppenchats und Besprechungschats.Get messages from all chats that a user is a participant in, including 1:1 chats, group chats, and meeting chats.
Erstellen eines Abonnements für neue ChatnachrichtenCreate subscription for new chat messages subscriptionsubscription Abhören auf neue und bearbeitete Chatnachrichten und Reaktionen auf diese.Listen for new and edited chat messages, and reactions to them.
Erstellen von chatMessage in einem ChatCreate chatMessage in a chat chatMessagechatMessage Senden einer Chatnachricht in einer vorhandenen 1:1- oder Gruppenchatunterhaltung.Send a chat message in an existing 1:1 or group chat conversation.
chatMessage aktualisierenUpdate chatMessage chatMessagechatMessage Aktualisieren der eigenschaft "policyViolation" einer Chatnachricht.Update the policyViolation property of a chat message.
Gehostete InhalteHosted content
Auflisten aller gehosteten InhalteList all hosted content chatMessageHostedContent-SammlungchatMessageHostedContent collection Alle gehosteten Inhalte in einer Chatnachricht erhalten.Get all hosted content in a chat message.
Gehosteten Inhalt erhaltenGet hosted content chatMessageHostedContentchatMessageHostedContent Erhalten sie gehostete Inhalte aus einer Chatnachricht.Get hosted content from a chat message.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
idid ZeichenfolgeString Schreibgeschützt.Read-only. Eindeutige ID der Nachricht.Unique ID of the message.
replyToIdreplyToId stringstring Schreibgeschützt.Read-only. ID der übergeordneten Chatnachricht oder Stammchatnachricht des Threads.ID of the parent chat message or root chat message of the thread. (Gilt nur für Chatnachrichten in Kanälen, nicht für Chats.)(Only applies to chat messages in channels, not chats.)
vonfrom identitySetidentitySet Schreibgeschützt.Read only. Details zum Absender der Chatnachricht.Details of the sender of the chat message.
etagetag stringstring Schreibgeschützt.Read-only. Versionsnummer der Chatnachricht.Version number of the chat message.
messageTypemessageType stringstring Der Typ der Chatnachricht.The type of chat message. Die möglichen Werte sind: message .The possible values are: message.
createdDateTimecreatedDateTime dateTimeOffsetdateTimeOffset Schreibgeschützt.Read only. Zeitstempel, wann die Chatnachricht erstellt wurde.Timestamp of when the chat message was created.
lastModifiedDateTimelastModifiedDateTime dateTimeOffsetdateTimeOffset Schreibgeschützt.Read only. Zeitstempel, wenn die Chatnachricht erstellt (Anfangseinstellung) oder geändert wird, auch wenn eine Reaktion hinzugefügt oder entfernt wird.Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.
lastEditedDateTimelastEditedDateTime dateTimeOffsetdateTimeOffset Schreibgeschützt.Read only. Zeitstempel, wenn Änderungen an der Chatnachricht vorgenommen wurden.Timestamp when edits to the chat message were made. Löst ein "Bearbeitet"-Flag in der Benutzeroberfläche von Teams aus.Triggers an "Edited" flag in the Teams UI. Wenn keine Bearbeitungen vorgenommen werden, ist der Wert null .If no edits are made the value is null.
deletedDateTimedeletedDateTime dateTimeOffsetdateTimeOffset Schreibgeschützt.Read only. Zeitstempel, an dem die Chatnachricht gelöscht wurde, oder NULL, wenn nicht gelöscht.Timestamp at which the chat message was deleted, or null if not deleted.
subjectsubject stringstring Der Betreff der Chatnachricht im Klartext.The subject of the chat message, in plaintext.
bodybody itemBodyitemBody Nur-Text-/HTML-Darstellung des Inhalts der Chatnachricht.Plaintext/HTML representation of the content of the chat message. Die Darstellung ist durch den ContentType im Text angegeben.Representation is specified by the contentType inside the body. Der Inhalt befindet sich immer in HTML, wenn die Chatnachricht eine chatMessageMention enthält.The content is always in HTML if the chat message contains a chatMessageMention.
Zusammenfassungsummary stringstring Zusammenfassungstext der Chatnachricht, die für Pushbenachrichtigungen und Zusammenfassungsansichten oder Fall back-Ansichten verwendet werden kann.Summary text of the chat message that could be used for push notifications and summary views or fall back views. Gilt nur für Kanalchatnachrichten, nicht für Chatnachrichten in einem Chat.Only applies to channel chat messages, not chat messages in a chat.
Anlagenattachments chatMessageAttachment-SammlungchatMessageAttachment collection Angefügte Dateien.Attached files. Anlagen sind derzeit schreibgeschützt – das Senden von Anlagen wird nicht unterstützt.Attachments are currently read-only – sending attachments is not supported.
Erwähnungenmentions chatMessageMention-SammlungchatMessageMention collection Liste der in der Chatnachricht erwähnten Entitäten.List of entities mentioned in the chat message. Derzeit unterstützt: user, bot, team, channel.Currently supports user, bot, team, channel.
Wichtigkeitimportance stringstring Die Wichtigkeit der Chatnachricht.The importance of the chat message. Die möglichen Werte sind: normal, high, urgent.The possible values are: normal, high, urgent.
Reaktionenreactions chatMessageReaction-SammlungchatMessageReaction collection Reaktionen auf diese Chatnachricht (z. B. "Gefällt mir").Reactions for this chat message (for example, Like).
Gebietsschemalocale stringstring Das Vom Client festgelegte Locale der Chatnachricht.Locale of the chat message set by the client.
policyViolationpolicyViolation chatMessagePolicyViolationchatMessagePolicyViolation Definiert die Eigenschaften einer Richtlinienverletzung, die von einer Anwendung zur Verhinderung von Datenverlust (Data Loss Prevention, DLP) festgelegt wird.Defines the properties of a policy violation set by a data loss prevention (DLP) application.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.The following is a JSON representation of the resource.

{
  "id": "string (identifier)",
  "replyToId": "string (identifier)",
  "from": {"@odata.type": "microsoft.graph.identitySet"},
  "etag": "string",
  "messageType": "string",
  "createdDateTime": "string (timestamp)",
  "lastModifiedDateTime": "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"},
  "deleted": true
}