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 lo que contenga, incluidos los mensajes y los archivos adjuntos.

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 la interfaz de línea de comandos:

    pip3 install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib oauth2client

  • Una app de Chat publicada. Para crear y publicar una app de Chat, consulta Cómo compilar una app de Google Chat.

  • Autorización configurada para la app de Chat. Borrar un espacio 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 de 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:

    import os.path

from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError

# 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 bien desde la URL de un espacio.

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

    python3 chat_space_delete.py

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