Method: spaces.members.delete

Supprime un abonnement. Pour obtenir un exemple, consultez Supprimer un utilisateur ou une application Google Chat d'un espace.

Les types d'authentification suivants sont acceptés :

  • Authentification de l'application avec approbation de l'administrateur et champ d'application de l'autorisation :

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

  • Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants :

    • https://www.googleapis.com/auth/chat.memberships
    • https://www.googleapis.com/auth/chat.memberships.app (pour supprimer l'application d'appel de l'espace)
    • https://www.googleapis.com/auth/chat.import (espaces en mode importation uniquement)
    • L'authentification de l'utilisateur accorde des droits d'administrateur lorsqu'un compte administrateur s'authentifie, useAdminAccess est true et que le champ d'application d'autorisation suivant est utilisé :
      • https://www.googleapis.com/auth/chat.admin.memberships

L'authentification des applications n'est pas compatible avec les cas d'utilisation suivants :

  • Supprimer un groupe Google d'un espace
  • Supprimer une application Chat d'un espace

Pour supprimer des membres d'un espace, le demandeur doit être gestionnaire de l'espace. Si vous utilisez l'authentification par application, l'application Chat doit être le créateur de l'espace.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de ressource de l'abonnement à supprimer. Les applications de chat peuvent supprimer les abonnements des utilisateurs humains ou les leurs. Les applications de chat ne peuvent pas supprimer les abonnements d'autres applications.

Lorsque vous supprimez un membre humain, vous devez utiliser le champ d'application chat.memberships avec l'authentification de l'utilisateur ou le champ d'application chat.memberships.app avec l'authentification de l'application et le format spaces/{space}/members/{member}. Vous pouvez utiliser l'adresse e-mail comme alias pour {member}. Par exemple, spaces/{space}/members/example@gmail.com où example@gmail.com est l'adresse e-mail de l'utilisateur Google Chat.

Lors de la suppression d'une appartenance à une application, les formats chat.memberships.app et spaces/{space}/members/app sont requis.

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

Paramètres de requête

Paramètres
useAdminAccess

boolean

Facultatif. Lorsque la valeur est true, la méthode s'exécute avec les droits d'administrateur Google Workspace de l'utilisateur.

L'utilisateur qui appelle doit être un administrateur Google Workspace disposant du droit "Gérer les conversations Chat et Espaces".

Nécessite le champ d'application OAuth 2.0 chat.admin.memberships.

Il n'est pas possible de supprimer les abonnements aux applications dans un espace avec un accès administrateur.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Membership.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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

Pour en savoir plus, consultez le guide d'autorisation.