chatMessage-RessourcentypchatMessage resource type

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen 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.

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.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Kanalnachrichten auflistenList Channel messages chatMessage-AuflistungchatMessage collection Liste aller Stamm Nachrichten in einem Kanal.List of all root messages in a channel.
Kanalnachricht abrufenGet Channel message chatMessagechatMessage Abrufen einer einzelnen Stammnachricht aus einem Kanal.Get a single root message from a channel.
Antworten in einer Nachricht auflistenList replies to a message chatMessage-AuflistungchatMessage collection Liste aller Antworten auf eine Nachricht im Kanal.List of all replies to a message in channel.
Antwort auf eine Nachricht abrufenGet a reply to a message chatMessagechatMessage Abrufen einer einzelnen Antwort auf eine Nachricht in einem Kanal.Get a single reply to a message in a channel.
Erstellen von Chat Message in einem KanalCreate chatMessage in a channel chatMessagechatMessage Erstellen Sie eine neue Nachricht auf oberster Ebene in einem Kanal.Create a new top-level message in a channel.
Antworten auf eine Nachricht in einem KanalReply to a message in a channel chatMessagechatMessage Antworten Sie auf eine Nachricht in einem Kanal.Reply to an existing message in a channel.
Erstellen von Chat Message in einem ChatCreate chatMessage in a chat chatMessagechatMessage Senden Sie eine Nachricht in einer vorhandenen 1:1-oder Gruppenchat-Unterhaltung.Send a message in an existing 1:1 or group chat conversation.
Auflisten von Nachrichten in einem ChatList messages in a chat chatMessagechatMessage Auflisten von Nachrichten in einem 1:1-oder Gruppenchat.List messages in a 1:1 or group chat.
Nachricht in Chat abrufenGet message in chat chatMessagechatMessage Eine einzelne Nachricht in einem Chat abrufen.Get a single message in a chat.
Auflisten aller gehosteten BilderList all hosted images hostedImage -SammlunghostedImage collection Dient zum Abrufen aller gehosteten Bilder in einer Nachricht.Get all hosted images in a message.
Gehostetes Bild abrufenGet hosted image hostedImagehostedImage Dient zum Abrufen eines gehosteten Bilds aus einer Nachricht.Get a hosted image from a message.
Get Hosted Image bytesGet hosted image bytes binäre Bild Datenbinary image data Dient zum Abrufen von binären Bild Daten eines gehosteten Bilds aus einer Nachricht.Get binary image data of a hosted image from a message.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
idid StringString SchreibgeschütztRead-only. Eindeutige ID der Nachricht.Unique Id of the message.
replyToIdreplyToId stringstring Schreibgeschützt.Read-only. ID der übergeordneten Nachricht/Stammnachricht des Threads.Id of the parent message/root message of the thread. (Gilt nur für Nachrichten in Kanälen, nicht in Chats)(Only applies to messages in channels not chats)
vonfrom identitySetidentitySet Schreibgeschützt.Read only. Einzelheiten über den Absender der Nachricht.Details of the sender of the message.
etagetag stringstring Schreibgeschützt.Read-only. Versionsnummer der Nachricht.Version number of the message.
messageTypemessageType chatMessageTypechatMessageType Der Typ der Nachricht.The type of message. Die möglichen Werte sind: message.The possible values are: message.
createdDateTimecreatedDateTime dateTimeOffsetdateTimeOffset Schreibgeschützt.Read only. Zeitstempel, wann die Nachricht erstellt wurde.Timestamp of when the message was created.
lastModifiedDateTimelastModifiedDateTime dateTimeOffsetdateTimeOffset Schreibgeschützt.Read only. Zeitstempel, wann die Nachricht erstellt oder bearbeitet wird, einschließlich beim Erstellen einer Antwort (wenn es sich um eine Stamm Nachricht in einem Kanal handelt) oder eine Reaktion wird hinzugefügt oder entfernt.Timestamp of when the message is created or edited, including when a reply is made (if it's a root message in a channel) or a reaction is added or removed.
deletedDateTimedeletedDateTime dateTimeOffsetdateTimeOffset Schreibgeschützt.Read only. Zeitstempel, wann die Nachricht gelöscht wurde, oder Null, wenn sie nicht gelöscht wurde.Timestamp at which the message was deleted, or null if not deleted.
subjectsubject stringstring Der Betreff der Nachricht, in Nur-Text.The subject of the message, in plaintext.
bodybody itemBodyitemBody Nur-Text-/HTML-Darstellung des Inhalts der Nachricht.Plaintext/HTML representation of the content of the message. Die Darstellung ist durch den ContentType im Text angegeben.Representation is specified by the contentType inside the body. Der Inhalt ist immer im HTML-Format, wenn die Nachricht eine chatMessageMention enthält.The content is always in HTML if the message contains a chatMessageMention.
Zusammenfassungsummary Zeichenfolgestring Zusammenfassungstext der Nachricht, die für Pushbenachrichtigungen und Zusammenfassungs- oder Fallbackansichten verwendet werden kann.Summary text of the message that could be used for push notifications and summary views or fall back views. Gilt nur für Kanalnachrichten, nicht für Chatnachrichten.Only applies to channel messages, not chat messages.
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 Entitäten, die in der Nachricht angegeben werden.List of entities mentioned in the message. Derzeit unterstützt: user, bot, team, channel.Currently supports user, bot, team, channel.
Wichtigkeitimportance chatMessageImportancechatMessageImportance Die Wichtigkeit der Nachricht.The importance of the message. Die möglichen Werte sind: normal, high, urgent.The possible values are: normal, high, urgent.
Reaktionenreactions chatMessageReaction-SammlungchatMessageReaction collection Reaktionen auf diese Nachricht (z. B. Gefällt mir).Reactions for this message (for example, Like).
Gebietsschemalocale stringstring Vom Client festgelegtes Gebietsschema der Nachricht.Locale of the message set by the client.

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",
  "policyViolation": "string",
  "reactions": [{"@odata.type": "microsoft.graph.chatMessageReaction"}],
  "locale": "string",
  "deleted": true
}