Method: spaces.members.delete

Löscht eine Mitgliedschaft. Ein Beispiel finden Sie im Hilfeartikel Nutzer oder Google Chat-Apps aus einem Gruppenbereich entfernen.

Erfordert eine Nutzerauthentifizierung.

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 zu löschenden Mitgliedschaft. Chat-Apps können die Mitgliedschaften menschlicher Nutzer oder ihre eigenen Mitgliedschaften löschen. Chat-Apps können Mitgliedschaften anderer Apps nicht löschen.

Zum Löschen einer Mitgliedschaft sind der Bereich chat.memberships 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 Bereich chat.memberships.app und das Format spaces/{space}/members/app erforderlich.

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

Abfrageparameter

Parameter
useAdminAccess

boolean

Wenn 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 OAuth 2.0-Bereich von chat.admin.memberships.

Das Löschen von App-Mitgliedschaften in einem Gruppenbereich wird über 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.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.