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 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 en la Métodospaces.list
en desde la API de Chat o desde 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 que puedes obtener de la Métodospaces.list
en la API de Chat o desde la URL de un espacio.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.
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.