Chat aktualisieren
Namespace: microsoft.graph
Aktualisieren sie die Eigenschaften eines Chatobjekts .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | Chat.ReadWrite | Nicht verfügbar. |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | ChatSettings.ReadWrite.Chat | Chat.ReadWrite.All |
HTTP-Anforderung
PATCH /chats/{chat-id}
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Content-Type | application/json. Erforderlich. |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung des Chatobjekts an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die mit dieser Aktion verwendet werden können.
Eigenschaft | Typ | Beschreibung |
---|---|---|
Thema | Zeichenfolge | Der Titel des Chats. Dies kann nur für einen Chat mit dem chatType-Wert festgelegt group werden. Die maximale Länge beträgt 250 Zeichen. Die Verwendung von ":" ist nicht zulässig. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen 200 OK response
Code und die aktualisierte Chatressource im Antworttext zurück.
Beispiele
Anforderung
PATCH https://graph.microsoft.com/v1.0/chats/19:1c5b01696d2e4a179c292bc9cf04e63b@thread.v2
Content-Type: application/json
{
"topic": "Group chat title update"
}
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#chats/$entity",
"id": "19:1c5b01696d2e4a179c292bc9cf04e63b@thread.v2",
"topic": "Group chat title update",
"createdDateTime": "2020-12-04T23:11:16.175Z",
"lastUpdatedDateTime": "2020-12-04T23:12:19.943Z",
"chatType": "group"
}