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