Chat-Ressourcentypchat resource type

Namespace: microsoft.graphNamespace: microsoft.graph

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. Um zu ermitteln, ob eine API in v 1.0 verfügbar ist, verwenden Sie die Versions Auswahl.To determine whether an API is available in v1.0, use the Version selector.

Bei einem Chat handelt es sich um eine Sammlung von Chat Messages 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.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription BerechtigungenPermissions
Auflisten von ChatsList chats Chat Sammlungchat collection Dient zum Abrufen der Liste der Chats, zu denen ein Benutzer gehört.Get the list of chats a user is part of. Nur delegiertDelegated only
Chat abrufenGet chat chatchat Liest die Eigenschaften und Beziehungen des Chats.Read properties and relationships of the chat. Nur delegiertDelegated only
Listen Chat MitgliederList chat members conversationMember-SammlungconversationMember collection Rufen Sie die Liste aller Benutzer im Chat ab.Get the list of all users in the chat. Delegierte und Anwendung *Delegated and application*
Chat Mitglied abrufenGet chat member conversationMemberconversationMember Einen einzelnen Benutzer im Chat abrufen.Get a single user in the chat. Delegierte und Anwendung *Delegated and application*
Auflisten von Nachrichten in einem ChatList messages in a chat chatMessagechatMessage Abrufen von Nachrichten in einem 1:1-Chat oder einem Gruppen-Chat.Get messages in a 1:1 or group chat. Delegierte und Anwendung *Delegated and application*
Nachricht in Chat abrufenGet message in chat chatMessagechatMessage Eine einzelne Nachricht in einem Chat abrufen.Get a single message in a chat. Delegierte und Anwendung *Delegated and application*

Hinweis: Achten Sie bei der Verwendung von Anwendungsberechtigungen darauf, dass Sie wissen, wie Sie die Chat-ID abrufen.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 und von Änderungsbenachrichtigungen für/Chats/getAllMessages mit Anwendungsberechtigungen abzurufen.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 der Erstellung des Chats.Date and time at which the chat was created. Schreibgeschützt.Read-only.
lastUpdatedDateTimelastUpdatedDateTime dateTimeOffsetdateTimeOffset Datum und Uhrzeit, zu der der Chat umbenannt oder die Mitgliedschaft geändert wurde.Date and time at which the chat was renamed or membership changed. lastUpdatedDateTime wird nicht aktualisiert, wenn eine Nachricht an den Chat gesendet wird.lastUpdatedDateTime is not updated when a message is sent to the chat. Schreibgeschützt.Read-only.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
installedAppsinstalledApps teamsAppInstallation-SammlungteamsAppInstallation collection Eine Sammlung aller apps im Chat.A collection of all the apps in the chat. Lässt NULL-Werte zu.Nullable.
membersmembers conversationMember-SammlungconversationMember collection Eine Sammlung aller Personen im Chat.A collection of all people in the chat. Lässt NULL-Werte zu.Nullable.
messagesmessages chatMessage-AuflistungchatMessage collection Eine Sammlung 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"
}

Siehe auchSee also