Obtén detalles sobre un evento de un espacio de Google Chat

En esta guía, se explica cómo usar la Método get activado el SpaceEvent recurso de la La API de Google Chat para obtener detalles sobre un evento de un espacio de Google Chat

El recurso SpaceEvent representa un cambio que se realizó en un espacio o en su elemento secundario. recursos, como mensajes, reacciones y membresías. Para aprender sobre los tipos de eventos admitidos, consulta el campo eventType de la Recurso SpaceEvent documentación de referencia.

Puedes solicitar eventos hasta 28 días antes de la fecha de la solicitud. El evento contiene la versión más reciente del recurso que cambió. Por ejemplo, solicitas un evento sobre un mensaje nuevo, pero el mensaje se actualizó posteriormente, el El servidor muestra el recurso Message actualizado en la carga útil del evento.

Para llamar a este método, debes usar user autenticación. Para obtener un evento, el usuario autenticado debe ser miembro del espacio en el que o para analizar cómo ocurrió el incidente.

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 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
    

Cómo obtener detalles sobre un evento espacial

Para obtener detalles sobre un SpaceEvent en Google Chat, haz lo siguiente:

  • Realiza una llamada al método get. en el SpaceEvent recurso.
  • Pasa el name de SpaceEvent para obtenerlo. Obtén el nombre SpaceEvent desde la SpaceEvent recurso de Google Chat.
  • Con usuario autenticación, especifica un alcance de autorización que admita el tipo de evento en tu solicitud. Como práctica recomendada, elige el alcance más restrictivo que le permita a tu app para funcionar.

A continuación, te mostramos cómo obtener un SpaceEvent con Autenticación de usuarios:

Python

  1. En el directorio de trabajo, crea un archivo llamado chat_space_event_get.py.
  2. Incluye el siguiente código en chat_space_event_get.py:

    """Gets a SpaceEvent resource from the Chat API."""
    
    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 = ['SCOPE']
    
    # 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()
        .spaceEvents()
        .get(
            # The space event to get.
            #
            # Replace SPACE with a space name.
            # Obtain the space name from the spaces resource of Chat API,
            # or from a space's URL.
            #
            # Replace SPACE_EVENT with a SpaceEvent name.
            # Obtain the spaceEvent name from the SpaceEvent resource of
            # Chat API.
            name='spaces/SPACE/spaceEvents/SPACE_EVENT'
        )
        .execute()
    )
    
    # Prints details about the created spaceEvent.
    print(result)
    
  3. En el código, reemplaza lo siguiente:

    • SCOPE: Es un permiso de autorización basado en el tipo de evento. Por ejemplo, si recibes un evento espacial sobre una membresía nueva, usa el permiso chat.memberships.readonly con el formato https://www.googleapis.com/auth/chat.memberships.readonly. Puedes obtener el tipo de evento del Método spaces.spaceEvents.list. Para aprender a usar este método, consulta Crea una lista de eventos de un espacio.
    • SPACE: Es un nombre de espacio, que puedes obtener desde Método spaces.list en la API de Chat o desde la URL de un espacio.
    • SPACE_EVENT: Es el nombre del espacio. evento, que puedes obtener del Método spaces.spaceEvents.list.
  4. En tu directorio de trabajo, compila y ejecuta la muestra:

    python3 chat_space_event_get.py
    

La API de Chat devuelve una instancia de SpaceEvent con los detalles del evento.