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:

  • App-Authentifizierung mit Administratorzulassung in der Entwicklervorschau und Autorisierungsbereich:

    • https://www.googleapis.com/auth/chat.app.delete (nur in Gruppenbereichen, die von der App erstellt wurden)

  • Nutzerauthentifizierung mit einem der folgenden Autorisierungsbereiche:

    • https://www.googleapis.com/auth/chat.delete
    • https://www.googleapis.com/auth/chat.import (nur Gruppenbereiche im Importmodus)
    • Bei der Nutzerauthentifizierung werden Administratorrechte gewährt, wenn sich ein Administratorkonto authentifiziert, useAdminAccess = true und der folgende Autorisierungsbereich verwendet wird:
      • https://www.googleapis.com/auth/chat.admin.delete

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. Wenn true festgelegt ist, 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.