Chatressourcentyp

Namespace: microsoft.graph

Ein Chat ist eine Sammlung von chatMessages zwischen einem oder mehreren Teilnehmern. Teilnehmer können Benutzer oder Apps sein.

Hinweis: Wenn der Chat einer onlineMeeting-Instanz zugeordnet ist, wirken sich einige der aufgeführten Methoden transitiv auf die Besprechung aus.

Methoden

Methode	Rückgabetyp	Beschreibung
Chatverwaltung
Chat erstellen	chat	Erstellen sie einen neuen Chat.
Chat abrufen	chat	Lesen sie die Eigenschaften und Beziehungen des Chats.
Chat aktualisieren	chat	Dient zum Aktualisieren der Eigenschaften des Chats.
Chatmitglieder auflisten	conversationMember-Sammlung	Rufen Sie die Liste aller Benutzer im Chat ab.
Chatmitglied hinzufügen	Header „Standort“	Fügen Sie dem Chat einen Benutzer hinzu.
Chatmitglied abrufen	conversationMember	Rufen Sie einen einzelnen Benutzer im Chat ab.
Chatmitglied entfernen	Keine	Entfernen sie einen Benutzer aus dem Chat.
Chat zwischen Benutzer und App erhalten	chat	Abrufen eines Einzelchats zwischen Benutzer und App
Nachrichten
Nachrichten im Chat auflisten	chatMessage	Abrufen von Nachrichten in einem Chat.
Nachricht in Chat abrufen	chatMessage	Eine einzelne Nachricht in einem Chat abrufen.
Erhalten von Nachrichten in allen Chats für Benutzer	Chatsammlung	Dient zum Abrufen von Nachrichten aus allen Chats, an denen ein Benutzer beteiligt ist.
Apps
Apps im Chat auflisten	teamsAppInstallation-Sammlung	Apps auflisten, die in einem Chat (und der zugehörigen Besprechung) installiert sind.
App im Chat abrufen	teamsAppInstallation	Abrufen einer bestimmten App, die in einem Chat (und der zugehörigen Besprechung) installiert ist.
App im Chat hinzufügen		Hinzufügen (Installieren) einer App in einem Chat (und einer zugehörigen Besprechung).
Aktualisieren der App im Chat	Keine	Aktualisieren Sie auf die neueste Version der App, die im Chat (und der zugehörigen Besprechung) installiert ist.
Deinstallieren der App aus dem Chat	Keine	Entfernen (Deinstallieren) der App aus einem Chat (und einer zugehörigen Besprechung).
Registerkarten
Registerkarten im Chat auflisten	teamsTab	Listenregisterkarten, die an einen Chat (und die zugehörige Besprechung) angeheftet sind.
Registerkarte im Chat abrufen	teamsTab	Dient zum Abrufen einer bestimmten Registerkarte, die an einen Chat (und die zugehörige Besprechung) angeheftet ist.
Registerkarte zum Chat hinzufügen	teamsTab	Hinzufügen (Anheften) einer Registerkarte zu einem Chat (und einer zugehörigen Besprechung).
Registerkarte "Aktualisieren" im Chat	teamsTab	Aktualisieren sie die Eigenschaften einer Registerkarte in einem Chat (und der zugehörigen Besprechung).
Registerkarte aus Chat entfernen	Keine	Entfernen (Lösen) einer Registerkarte aus einem Chat (und der zugehörigen Besprechung).

Hinweis: Wenn Sie Anwendungsberechtigungen verwenden, stellen Sie sicher, dass Sie wissen, wie Sie die Chat-ID abrufen. Da das Auflisten von Chats mit Anwendungsberechtigungen nicht unterstützt wird, sind nicht alle Szenarien möglich. Es ist möglich, Chat-IDs mit delegierten Berechtigungen und von Änderungsbenachrichtigungen für /chats/getAllMessages mit Anwendungsberechtigungen abzurufen.

Eigenschaften

Eigenschaft	Typ	Beschreibung
chatType	chatType	Gibt den Chattyp an. Mögliche Werte: group, oneOnOne, meeting, unknownFutureValue
createdDateTime	dateTimeOffset	Datum und Uhrzeit der Erstellung des Chats. Schreibgeschützt.
id	Zeichenfolge	Der eindeutige Bezeichner des Chats. Schreibgeschützt.
lastUpdatedDateTime	dateTimeOffset	Datum und Uhrzeit, zu dem der Chat umbenannt wurde oder die Liste der Mitglieder zuletzt geändert wurde. Schreibgeschützt.
onlineMeetingInfo	teamworkOnlineMeetingInfo	Stellt Details zu einer Onlinebesprechung dar. Wenn der Chat keiner Onlinebesprechung zugeordnet ist, ist die Eigenschaft leer. Schreibgeschützt.
tenantId	Zeichenfolge	Der Bezeichner des Mandanten, in dem der Chat erstellt wurde. Schreibgeschützt.
Thema	String	(Optional) Betreff oder Thema für den Chat. Nur für Gruppenchats verfügbar.
webUrl	Zeichenfolge	Die URL für den Chat in Microsoft Teams. Die URL sollte als undurchsichtiger Blob behandelt und nicht analysiert werden. Schreibgeschützt.

chatType-Werte

Element	Wert	Beschreibung
oneOnOne	0	Gibt an, dass es sich bei dem Chat um einen 1:1-Chat handelt. Die Größe der Teilnehmerliste ist für diese Art von Chat festgelegt. Mitglieder können nicht entfernt/hinzugefügt werden.
Gruppe	1	Gibt an, dass der Chat ein Gruppenchat ist. Die Teilnehmerlistengröße (von mindestens zwei Personen) kann für diese Art von Chat aktualisiert werden. Mitglieder können später entfernt/hinzugefügt werden.
Sitzung	2	Gibt an, dass der Chat einer Onlinebesprechung zugeordnet ist. Diese Art von Chat wird nur im Rahmen der Erstellung einer Onlinebesprechung erstellt.
unknownFutureValue	3	Evolvable Enumeration Sentinel-Wert. Nicht verwenden.

Beziehungen

Beziehung	Typ	Beschreibung
installedApps	teamsAppInstallation-Sammlung	Eine Sammlung aller Apps im Chat. Lässt NULL-Werte zu.
members	conversationMember-Sammlung	Eine Sammlung aller Mitglieder im Chat. Lässt NULL-Werte zu.
messages	chatMessage-Auflistung	Eine Sammlung aller Nachrichten im Chat. Nullwerte zulassend.
Registerkarten	teamsTab-Auflistung	Eine Sammlung aller Registerkarten im Chat. Nullwerte zulassend.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "id": "string (identifier)",
  "topic": "string",
  "createdDateTime": "dateTimeOffset",
  "lastUpdatedDateTime": "dateTimeOffset",
  "chatType": "string",
  "webUrl": "string",
  "tenantId": "string",
  "onlineMeetingInfo": {
    "@odata.type": "microsoft.graph.teamworkOnlineMeetingInfo"
  }
}

Siehe auch

• channel
• chatMessage