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 en el que 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 donde 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.
La autorización configurada para la app de Chat. Si se borra un espacio, se requiere la autenticación del usuario con el permiso 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.
La autorización configurada para la app de Chat. Si se borra un espacio, se requiere la autenticación del usuario con el permiso de autorización
chat.delete
de un usuario que tenga 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 la solicitud:
- Especifica el alcance de la autorización
chat.delete
. - Llama al método
delete
en el recursoSpace
. - Pasa el
name
del espacio que quieres borrar.
Para borrar un espacio, sigue estos pasos:
Python
- En el directorio de trabajo, crea un archivo llamado
chat_space_delete.py
. 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()
En el código, reemplaza
SPACE
por el nombre del espacio, que puedes obtener del métodospaces.list
en la API de Chat o de la URL de un espacio.En tu directorio de trabajo, compila y ejecuta la muestra:
python3 chat_space_delete.py
Node.js
- En el directorio de trabajo, crea un archivo llamado
delete-space.js
. 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);
En el código, reemplaza
SPACE
por un nombre de espacio, que puedes obtener del métodospaces.list
en la API de Chat o de la URL de un espacio.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.
Temas relacionados
- Crea un espacio
- Obtener detalles sobre un espacio
- Crea listas de espacios.
- Actualiza un espacio.
- Borra un espacio.
- Configura un espacio.
- Busca un espacio para mensaje directo.