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. Borrar un también borra todo su contenido, incluidos los mensajes y 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 Apps de Chat
  • Los espacios con nombre son lugares persistentes donde las personas envían mensajes, y colaborar.

Requisitos previos

Python

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

  • Las bibliotecas cliente de Google más recientes para Python. Para instalarlas o actualizarlas, 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 ver los pasos, consulta Compila una app de Google Chat.

  • Autorización configurada para la app de Chat. Borrando un espacio requiere Autenticación de usuarios con el permiso de autorización chat.delete de un usuario que tiene permiso para borrar el espacio especificado.

Node.js

  • Node.js y npm

  • Las bibliotecas cliente de Google más recientes para Node.js. Para instalarlas, ejecuta el siguiente comando: 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 ver los pasos, consulta Compila una app de Google Chat.

  • Autorización configurada para la app de Chat. Borrando un espacio requiere Autenticación de usuarios con el permiso de autorización chat.delete de un usuario que tiene permiso para borrar el espacio especificado.

Cómo borrar un espacio con nombre

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

  • Especifica el alcance de la autorización chat.delete.
  • Llama al Método delete en el recurso Space.
  • Pasa el name del espacio que quieres 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 en la Método spaces.list en desde la API de Chat o desde la URL de un espacio.

  4. En tu 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 que puedes obtener de la 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 el proceso es satisfactorio, el cuerpo de la respuesta estará vacío, lo que indica que el espacio es borrar.