Exclure un membre d'un espace

Ce guide explique comment utiliser la delete() méthode sur la ressource Membership de l'API Google Chat pour supprimer des membres d'un espace, ce qui revient à supprimer une adhésion. Les gestionnaires d'un espace ne peuvent pas être supprimés s'ils sont les seuls gestionnaires de l'espace. Attribuez le rôle de gestionnaire de l'espace à un autre utilisateur avant de supprimer ces adhésions.

Si vous êtes administrateur Google Workspace, vous pouvez supprimer des utilisateurs, des groupes Google ou des applications Chat de n'importe quel espace de votre organisation Google Workspace.

La ressource Membership représente si un utilisateur humain ou une application Google Chat est invité à, partie de, ou absent d'un espace.

Prérequis

Node.js

Supprimer un membre d'un espace en tant qu'utilisateur

Pour supprimer un utilisateur, un groupe Google ou une application Chat d'un espace avec authentification de l'utilisateur, transmettez les éléments suivants dans votre requête :

  • Spécifiez le champ d'application d'autorisation chat.memberships. L'utilisateur autorisant doit être autorisé à supprimer l'utilisateur ou le groupe Google de l'espace. Pour supprimer une application Chat, spécifiez le champ d'application d'autorisation chat.memberships.app (les applications ne peuvent supprimer que leur propre adhésion, et non celle d'autres applications). Nous vous recommandons de choisir le champ d'application le plus restrictif qui permette à votre application de fonctionner.
  • Appelez la DeleteMembership() méthode.
  • Transmettez le name de l'adhésion à supprimer. Si l'adhésion appartient au seul gestionnaire d'un espace, attribuez le rôle de gestionnaire de l'espace à un autre utilisateur avant de supprimer cette adhésion.

Voici comment supprimer une adhésion avec authentification de l'utilisateur :

Node.js

chat/client-libraries/cloud/delete-space-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.delete'];

// This sample shows how to delete a space with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(
    USER_AUTH_OAUTH_SCOPES,
  );

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here
    name: 'spaces/SPACE_NAME',
  };

  // Make the request
  const response = await chatClient.deleteSpace(request);

  // Handle the response
  console.log(response);
}

await main();

Pour exécuter cet exemple, remplacez les éléments suivants :

  • SPACE_NAME : ID du name de l'espace. Vous pouvez obtenir l'ID en appelant la ListSpaces() méthode ou à partir de l'URL de l'espace.
  • MEMBER_NAME : ID du membre name. Vous pouvez obtenir l'ID en appelant la ListMemberships() méthode.

Si la requête aboutit, le corps de la réponse renvoie l'adhésion avec 'state': 'NOT_A_MEMBER', ce qui indique que le membre ne fait plus partie de l'espace.

{
    "name": "spaces/SPACE_NAME/members/MEMBER_NAME",
    "state": "NOT_A_MEMBER"
}

Supprimer un membre d'un espace en tant qu'application Chat

L'authentification des applications nécessite une approbation unique de l'administrateur.

Pour supprimer un utilisateur, un groupe Google ou une application Chat d'un espace avec authentification de l'application, transmettez les éléments suivants dans votre requête :

  • Spécifiez le champ d'application d'autorisation chat.app.memberships. La suppression de l'adhésion d'un gestionnaire d'espace n'est possible que dans les espaces créés par des applications Chat.
  • Appelez la delete méthode sur la membership ressource.
  • Transmettez le name de l'adhésion à supprimer. Si l'adhésion appartient au seul gestionnaire d'un espace, attribuez le rôle de gestionnaire de l'espace à un autre utilisateur avant de supprimer cette adhésion.

Écrire un script qui appelle l'API Chat

Voici comment supprimer une adhésion avec authentification de l'application :

Python

  1. Dans votre répertoire de travail, créez un fichier nommé chat_membership_delete_app.py.

  2. Incluez le code suivant dans chat_membership_delete_app.py :

    from google.oauth2 import service_account
from apiclient.discovery import build

# Define your app's authorization scopes.
# When modifying these scopes, delete the file token.json, if it exists.
SCOPES = ["https://www.googleapis.com/auth/chat.app.memberships"]

def main():
    '''
    Authenticates with Chat API using app authentication,
    then deletes the specified membership.
    '''

    # Specify service account details.
    creds = (
        service_account.Credentials.from_service_account_file('credentials.json')
        .with_scopes(SCOPES)
    )

    # Build a service endpoint for Chat API.
    chat = build('chat', 'v1', credentials=creds)

    # Use the service endpoint to call Chat API.
    result = chat.spaces().members().delete(

        # The membership to delete.
        #
        # Replace SPACE with a space name.
        # Obtain the space name from the spaces resource of Chat API,
        # or from a space's URL.
        #
        # Replace MEMBER with a membership name.
        # Obtain the membership name from the memberships resource of
        # Chat API. To delete a Chat app's membership, replace MEMBER
        # with app; an alias for the app calling the API.
        name='spaces/SPACE/members/MEMBER'

    ).execute()

    # Print Chat API's response in your command line interface.
    # When deleting a membership, the response body is empty.
    print(result)

if __name__ == '__main__':
    main()

  3. Dans le code, remplacez les éléments suivants :

    • SPACE : nom d'un espace, que vous pouvez obtenir à partir de la méthode spaces.list de l'API Chat ou de l'URL d'un espace.

    • MEMBER : nom d'une adhésion, que vous pouvez obtenir à partir de la méthode spaces.members.list de l'API Chat. Pour supprimer l'adhésion d'une application, remplacez MEMBER par app.

  4. Dans votre répertoire de travail, compilez et exécutez l'exemple :

    python3 chat_membership_delete_app.py

Si la requête aboutit, le corps de la réponse renvoie l'adhésion avec 'state': 'NOT_A_MEMBER', ce qui indique que le membre ne fait plus partie de l'espace.

{
    "name": "spaces/SPACE/members/MEMBER",
    "state": "NOT_A_MEMBER"
}

Supprimer des utilisateurs ou des groupes Google d'un espace en tant qu'administrateur Google Workspace

Si vous êtes administrateur Google Workspace, vous pouvez appeler la méthode DeleteMembership() pour supprimer des utilisateurs, des groupes Google ou des applications Chat de n'importe quel espace de votre organisation Google Workspace.

Pour appeler cette méthode en tant qu'administrateur Google Workspace, procédez comme suit :

Pour en savoir plus et obtenir des exemples, consultez Gérer les espaces Google Chat en tant qu'administrateur Google Workspace.

Limites et points à noter