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 para determinar si se produjo un error.
Requisitos previos
Python
- Una empresa o empresa de Google Workspace con acceso a Google Chat.
- Configura tu entorno:
- Crea un proyecto de Google Cloud
- Configura la pantalla de consentimiento de OAuth.
- Habilita y configura la API de Google Chat con un nombre. y la descripción de tu app de Chat.
-
Crea credenciales de ID de cliente de OAuth para una aplicación de escritorio. Para ejecutar la muestra
guarda las credenciales como un archivo JSON llamado
client_secrets.json
en tu directorio local.
- Elige un alcance de autorización que admita la autenticación de usuarios.
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 elSpaceEvent
recurso. - Pasa el
name
deSpaceEvent
para obtenerlo. Obtén el nombreSpaceEvent
desde laSpaceEvent
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
- En el directorio de trabajo, crea un archivo llamado
chat_space_event_get.py
. 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)
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 permisochat.memberships.readonly
con el formatohttps://www.googleapis.com/auth/chat.memberships.readonly
. Puedes obtener el tipo de evento del Métodospaces.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étodospaces.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étodospaces.spaceEvents.list
.
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.