Method: spaces.members.delete

Löscht eine Mitgliedschaft. Ein Beispiel finden Sie unter Nutzer oder Google Chat-App aus einem Gruppenbereich entfernen.

Unterstützt die folgenden Authentifizierungstypen:

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

    • https://www.googleapis.com/auth/chat.app.memberships

  • Nutzerauthentifizierung mit einem der folgenden Autorisierungsbereiche:

    • https://www.googleapis.com/auth/chat.memberships
    • https://www.googleapis.com/auth/chat.memberships.app (um die Anruf-App aus dem Gruppenbereich zu entfernen)
    • 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.memberships

Wenn Sie die Mitgliedschaften von Administratoren von Gruppenbereichen löschen möchten, muss der Antragsteller selbst Administrator des Gruppenbereichs sein. Wenn Sie die App-Authentifizierung verwenden, muss die Anwendung der Ersteller des Gruppenbereichs sein.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Ressourcenname der Mitgliedschaft, die gelöscht werden soll. Chat-Apps können die Mitgliedschaften von Nutzern oder die eigenen Mitgliedschaften löschen. Mit Chat-Apps können keine Mitgliedschaften anderer Apps gelöscht werden.

Zum Löschen einer Mitgliedschaft einer natürlichen Person ist der Bereich chat.memberships mit Nutzerauthentifizierung oder der Bereich chat.memberships.app mit App-Authentifizierung und das Format spaces/{space}/members/{member} erforderlich. Sie können die E-Mail-Adresse als Alias für {member} verwenden. Beispiel: spaces/{space}/members/example@gmail.com, wobei example@gmail.com die E-Mail-Adresse des Google Chat-Nutzers ist.

Zum Löschen einer App-Mitgliedschaft sind der chat.memberships.app-Umfang und das spaces/{space}/members/app-Format erforderlich.

Format: spaces/{space}/members/{member} oder spaces/{space}/members/app

Abfrageparameter

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.memberships OAuth 2.0-Bereich.

Das Löschen von App-Mitgliedschaften in einem Gruppenbereich wird mit Administratorzugriff nicht unterstützt.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Membership.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.