Chatressourcentypchat resource type

Namespace: microsoft.graphNamespace: microsoft.graph

Ein Chat ist eine Sammlung von chatMessages zwischen einem oder mehreren Teilnehmern.A chat is a collection of chatMessages between one or more participants. Teilnehmer können Benutzer oder Apps sein.Participants can be users or apps.

Hinweis: Wenn der Chat einer onlineMeeting-Instanz zugeordnet ist, wirkt sich einige der aufgeführten Methoden transitiv auf die Besprechung aus.Note: If the chat is associated with an onlineMeeting instance, then some of the listed methods will transitively impact the meeting.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Chat erstellenCreate chat chatchat Erstellen sie einen neuen Chat.Create a new chat.
Chat abrufenGet chat chatchat Lesen von Eigenschaften und Beziehungen des Chats.Read properties and relationships of the chat.
Chat aktualisierenUpdate chat chatchat Aktualisieren der Eigenschaften des Chats.Update properties of the chat.
Chatmitglieder auflistenList chat members conversationMember-SammlungconversationMember collection Hier erhalten Sie die Liste aller Benutzer im Chat.Get the list of all users in the chat.
Chatmitglied hinzufügenAdd chat member Header „Standort“Location header Fügen Sie dem Chat einen Benutzer hinzu.Add a user to the chat.
Chatmitglied abrufenGet chat member conversationMemberconversationMember Holen Sie sich einen einzelnen Benutzer im Chat.Get a single user in the chat.
Chatmitglied entfernenRemove chat member KeineNone Entfernen eines Benutzers aus dem Chat.Remove a user from the chat.
Auflisten von Nachrichten im ChatList messages in chat chatMessagechatMessage Nachrichten in einem Chat erhalten.Get messages in a chat.
Nachricht in Chat abrufenGet message in chat chatMessagechatMessage Eine einzelne Nachricht in einem Chat abrufen.Get a single message in a chat.
Chat zwischen Benutzer und App erhaltenGet chat between user and app chatchat Get one-on-one chat between user and the appGet one-on-one chat between user and the app
Apps im Chat auflistenList apps in chat teamsAppInstallation-SammlungteamsAppInstallation collection Auflisten von Apps, die in einem Chat (und der zugehörigen Besprechung) installiert sind.List apps installed in a chat (and associated meeting).
App im Chat herunterladenGet app in chat teamsAppInstallationteamsAppInstallation Get a specific app installed in a chat (and associated meeting).Get a specific app installed in a chat (and associated meeting).
App im Chat hinzufügenAdd app in chat Fügen Sie eine App in einem Chat (und der zugehörigen Besprechung) hinzu (installieren).Add (install) an app in a chat (and associated meeting).
Upgrade der App im ChatUpgrade app in chat KeineNone Aktualisieren Sie auf die neueste Version der App, die im Chat (und der zugehörigen Besprechung) installiert ist.Update to the latest version of the app installed in chat (and associated meeting).
Deinstallieren der App aus dem ChatUninstall app from chat KeineNone Entfernen (Deinstallieren) der App aus einem Chat (und der zugehörigen Besprechung).Remove (uninstall) app from a chat (and associated meeting).
Registerkarten im Chat auflistenList tabs in chat teamsTabteamsTab Listenregisterkarten, die an einen Chat angeheftet sind (und zugeordnete Besprechung).List tabs pinned to a chat (and associated meeting).
Registerkarte im Chat erhaltenGet tab in chat teamsTabteamsTab Get a specific tab pinned to a chat (and associated meeting).Get a specific tab pinned to a chat (and associated meeting).
Registerkarte zum Chat hinzufügenAdd tab to chat teamsTabteamsTab Fügen Sie einem Chat (und der zugehörigen Besprechung) eine Registerkarte hinzu (anheften).Add (pin) a tab to a chat (and associated meeting).
Registerkarte aktualisieren im ChatUpdate tab in chat teamsTabteamsTab Aktualisieren Sie die Eigenschaften einer Registerkarte in einem Chat (und der zugehörigen Besprechung).Update the properties of a tab in a chat (and associated meeting).
Registerkarte aus Chat entfernenRemove tab from chat KeineNone Entfernen (Entpin) einer Registerkarte aus einem Chat (und der zugehörigen Besprechung).Remove (unpin) a tab from a chat (and associated meeting).

Hinweis: Achten Sie bei der Verwendung von Anwendungsberechtigungen darauf, dass Sie wissen, wie Sie die Chat-ID erhalten.Note: When using application permissions, be sure you know how you're going to get the chat ID. Da das Auflisten von Chats mit Anwendungsberechtigungen nicht unterstützt wird, sind nicht alle Szenarien möglich.Because listing chats with application permissions is not supported, not all scenarios are possible. Es ist möglich, Chat-IDs mit delegierten Berechtigungen sowie Änderungsbenachrichtigungen für /chats/getAllMessages mit Anwendungsberechtigungen zu erhalten.It is possible to get chat IDs with delegated permissions, and from change notifications for /chats/getAllMessages with application permissions.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
idid StringString Der eindeutige Bezeichner des Chats.The chat's unique identifier. Schreibgeschützt.Read-only.
Thematopic StringString (Optional) Betreff oder Thema für den Chat.(Optional) Subject or topic for the chat. Nur für Gruppenchats verfügbar.Only available for group chats.
createdDateTimecreatedDateTime dateTimeOffsetdateTimeOffset Datum und Uhrzeit, zu dem der Chat erstellt wurde.Date and time at which the chat was created. Schreibgeschützt.Read-only.
lastUpdatedDateTimelastUpdatedDateTime dateTimeOffsetdateTimeOffset Datum und Uhrzeit, zu dem der Chat umbenannt wurde, oder Liste der Mitglieder wurden zuletzt geändert.Date and time at which the chat was renamed or list of members were last changed. Schreibgeschützt.Read-only.
chatTypechatType chatTypechatType Gibt den Typ des Chats an.Specifies the type of chat. Mögliche Werte sind: group , oneOnOne und meeting .Possible values are:group, oneOnOne and meeting.

chatType-WertechatType values

ElementMember WertValue BeschreibungDescription
oneOnOneoneOnOne 00 Gibt an, dass es sich bei dem Chat um einen 1:1-Chat handelt.Indicates that the chat is a 1:1 chat. Die Rostergröße ist für diesen Chattyp festgelegt. Member können nicht entfernt/hinzugefügt werden.The roster size is fixed for this type of chat; members cannot be removed/added.
groupgroup 11 Gibt an, dass es sich bei dem Chat um einen Gruppenchat handelt.Indicates that the chat is a group chat. Die Rostergröße (von mindestens zwei Personen) kann für diese Art von Chat aktualisiert werden.The roster size (of at least two people) can be updated for this type of chat. Mitglieder können später entfernt/hinzugefügt werden.Members can be removed/added later.
besprechungmeeting 22 Gibt an, dass der Chat einer Online-Besprechung zugeordnet ist.Indicates that the chat is associated with an online meeting. Diese Art von Chat wird nur im Rahmen der Erstellung einer Online-Besprechung erstellt.This type of chat is only created as part of the creation of an online meeting.
unknownFutureValueunknownFutureValue 33 Sentinel-Wert, um zukünftige Werte anzugeben.Sentinel value to indicate future values.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
installedAppsinstalledApps teamsAppInstallation-SammlungteamsAppInstallation collection Eine Auflistung aller Apps im Chat.A collection of all the apps in the chat. Lässt NULL-Werte zu.Nullable.
membersmembers conversationMember-SammlungconversationMember collection Eine Auflistung aller Mitglieder im Chat.A collection of all the members in the chat. Lässt NULL-Werte zu.Nullable.
messagesmessages chatMessage-AuflistungchatMessage collection Eine Auflistung aller Nachrichten im Chat.A collection of all the messages in the chat. Nullwerte zulassend.Nullable.

JSON-DarstellungJSON representation

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

{
  "id": "string (identifier)",
  "topic": "string",
  "createdDateTime": "dateTimeOffset",
  "lastUpdatedDateTime": "dateTimeOffset",
  "chatType": "String"
}

Siehe auchSee also