Supprimer un espace

Ce guide explique comment utiliser la delete() méthode sur la ressource Space de l'API Google Chat pour supprimer un espace nommé lorsqu' il n'est plus nécessaire. La suppression d'un espace supprime également tout ce qu'il contient, y compris les messages et les pièces jointes.

Si vous êtes administrateur Google Workspace, vous pouvez appeler la méthode delete() pour supprimer n'importe quel espace nommé dans votre organisation Google Workspace.

La ressource Space représente un emplacement où les personnes et les applications Chat peuvent envoyer des messages, partager des fichiers et collaborer. Il existe plusieurs types d'espaces :

  • Les messages privés (MP) sont des conversations entre deux utilisateurs ou entre un utilisateur et une application Chat.
  • Les chats de groupe sont des conversations entre trois utilisateurs ou plus et des applications Chat.
  • Les espaces nommés sont des emplacements persistants où les utilisateurs envoient des messages, partagent des fichiers et collaborent.

Prérequis

Node.js

Supprimer un espace nommé en tant qu'utilisateur

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

  • Spécifiez le champ d'application d'autorisation chat.delete.
  • Appelez la DeleteSpace() méthode.
  • Transmettez le name de l'espace à supprimer.

Voici comment supprimer un espace :

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 SPACE_NAME par l'ID du champ de l'espace.name Vous pouvez obtenir l'ID en appelant la ListSpaces() méthode ou à partir de l'URL de l'espace.

Supprimer un espace nommé en tant qu'application Chat

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

Avec l'authentification de l'application, vous ne pouvez supprimer que les espaces créés par les applications Chat.

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

  • Spécifiez le champ d'application d'autorisation chat.app.delete.
  • Appelez la delete méthode sur la Space ressource.
  • Transmettez le name de l'espace à supprimer.

Écrire un script qui appelle l'API Chat

Voici comment supprimer un espace :

Python

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

  2. Incluez le code suivant dans chat_space_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.delete"]

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

    # 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().delete(

          # The space 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.
          name='spaces/SPACE'

      ).execute()

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

if __name__ == '__main__':
    main()

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

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

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

    python3 chat_space_delete_app.py

Si la requête aboutit, le corps de la réponse est vide, ce qui indique que l'espace est supprimé.

Supprimer un espace nommé en tant qu'administrateur Google Workspace

Si vous êtes administrateur Google Workspace, vous pouvez appeler la méthode DeleteSpace() pour supprimer n'importe quel espace nommé dans 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.