Cómo borrar un espacio

En esta guía, se explica cómo usar el método delete en el recurso Space de la API de Google Chat para borrar un espacio con nombre cuando ya no sea necesario. Si borras un espacio, también se borrará todo su contenido, incluidos los mensajes y los archivos adjuntos.

El recurso Space representa un lugar donde las personas y las apps de Chat pueden enviar mensajes, compartir archivos y colaborar. Existen varios tipos de espacios:

  • Los mensajes directos (MD) son conversaciones entre dos usuarios, o un usuario, y una app de Chat.
  • Los chats en grupo son conversaciones entre tres o más usuarios y las apps de Chat.
  • Los espacios con nombre son lugares persistentes en los que las personas envían mensajes, comparten archivos y colaboran.

Requisitos previos

Python

  • Python 3.6 o superior
  • La herramienta de administración de paquetes pip

  • Las bibliotecas cliente de Google más recientes para Python. Para instalarlos o actualizarlos, ejecuta el siguiente comando en tu interfaz de línea de comandos:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
  • Un proyecto de Google Cloud con la API de Google Chat habilitada y configurada Para conocer los pasos, consulta Compila una app de Google Chat.

  • Autorización configurada para la app de Chat. Si deseas borrar un espacio, es necesario que realices una autenticación del usuario con el alcance de autorización chat.delete de un usuario que tenga permiso para borrar el espacio especificado.

Node.js

  • Node.js y npm

  • Las bibliotecas cliente de Google más recientes para Node.js. Para instalarlos, ejecuta el siguiente comando en tu interfaz de línea de comandos:

    npm install @google-cloud/local-auth @googleapis/chat
  • Un proyecto de Google Cloud con la API de Google Chat habilitada y configurada Para conocer los pasos, consulta Compila una app de Google Chat.

  • Autorización configurada para la app de Chat. Si deseas borrar un espacio, es necesario que realices una autenticación del usuario con el alcance de autorización chat.delete de un usuario que tenga permiso para borrar el espacio especificado.

Borrar un espacio con nombre

Para borrar un espacio existente en Google Chat, pasa lo siguiente en la solicitud:

  • Especifica el alcance de la autorización de chat.delete.
  • Llama al método delete en el recurso Space.
  • Pasa el name del espacio que deseas borrar.

Para borrar un espacio, sigue estos pasos:

Python

  1. En el directorio de trabajo, crea un archivo llamado chat_space_delete.py.

  2. Incluye el siguiente código en chat_space_delete.py:

    from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.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.delete"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then deletes the specified space.
    '''

    # Authenticate with Google Workspace
    # and get user authorization.
    flow = InstalledAppFlow.from_client_secrets_file(
                      'client_secrets.json', SCOPES)
    creds = flow.run_local_server()

    # 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. En el código, reemplaza SPACE por el nombre del espacio, que puedes obtener del método spaces.list en la API de Chat o desde la URL de un espacio.

  4. En el directorio de trabajo, compila y ejecuta la muestra:

    python3 chat_space_delete.py

Node.js

  1. En el directorio de trabajo, crea un archivo llamado delete-space.js.

  2. Incluye el siguiente código en delete-space.js:

    const chat = require('@googleapis/chat');
const {authenticate} = require('@google-cloud/local-auth');

/**
* Deletes a Chat space.
* @return {!Promise<!Object>}
*/
async function deleteSpace() {
  const scopes = [
    'https://www.googleapis.com/auth/chat.delete',
  ];

  const authClient =
      await authenticate({scopes, keyfilePath: 'client_secrets.json'});

  const chatClient = await chat.chat({version: 'v1', auth: authClient});

  return await chatClient.spaces.delete({name: 'spaces/SPACE'});
}

deleteSpace().then(console.log);

  3. En el código, reemplaza SPACE por un nombre de espacio, que puedes obtener del método spaces.list en la API de Chat o desde la URL de un espacio.

  4. En tu directorio de trabajo, ejecuta la muestra:

    node delete-space.js

    Si se ejecuta de forma correcta, el cuerpo de la respuesta estará vacío, lo que indica que se borró el espacio.