Method: spaces.delete

Löscht einen benannten Gruppenbereich. Es wird immer ein abfolgebasiertes Löschen durchgeführt. Das bedeutet, dass auch die untergeordneten Ressourcen des Gruppenbereichs gelöscht werden, z. B. Nachrichten, die im Gruppenbereich gepostet wurden, und Mitgliedschaften im Gruppenbereich. Ein Beispiel finden Sie unter Chatbereich löschen.

Unterstützt die folgenden Authentifizierungstypen:

  • Entwicklervorschau: App-Authentifizierung mit Administratorgenehmigung. Erforderlich, wenn der Gruppenbereich mit der App-Authentifizierung in der Chat App erstellt wurde.

  • Nutzerauthentifizierung: Sie können diese Methode mit Administratorberechtigungen authentifizieren und autorisieren, indem Sie das Feld useAdminAccess in der Anfrage festlegen.

HTTP-Anfrage

DELETE https://chat.googleapis.com/v1/{name=spaces/*}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Ressourcenname des zu löschenden Gruppenbereichs.

Format: spaces/{space}

Suchparameter

Parameter
useAdminAccess

boolean

Optional. Bei true wird die Methode mit den Google Workspace-Administratorberechtigungen des Nutzers ausgeführt.

Der anrufende Nutzer muss ein Google Workspace-Administrator mit der Berechtigung Unterhaltungen in Chats und Gruppenbereichen verwalten sein.

Erfordert den chat.admin.delete OAuth 2.0-Bereich.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, ist der Antworttext ein leeres JSON-Objekt.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/chat.app.delete
  • https://www.googleapis.com/auth/chat.admin.delete
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.delete

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.