En esta guía, se explica cómo usar el método get
en el recurso Media
de la
La API de Google Chat para obtener metadatos sobre el archivo adjunto de un mensaje. La respuesta es una
instancia de la
Recurso Attachment
.
Cuando el usuario envía un mensaje a tu app, Google Chat envía un
Evento de interacción MESSAGE
.
El evento de interacción que recibe tu app incluye el cuerpo de la solicitud, que es el
Carga útil de JSON que representa el evento de interacción, incluidos los adjuntos. El
datos en el adjunto varían según si el adjunto está
contenido subido (un archivo local) o es un archivo almacenado en Drive. El
Recurso Media
representa un archivo subido a Google Chat, como imágenes, videos y documentos.
El
Recurso Attachment
representa una instancia de contenido multimedia (un archivo) adjunto a un mensaje. El Attachment
incluye los metadatos sobre el adjunto, como
donde se guardan.
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.
Recibe el archivo adjunto de un mensaje
Para obtener metadatos de forma asíncrona sobre el archivo adjunto de un mensaje en Google Chat, pasa lo siguiente en tu solicitud:
- Especifica el alcance de la autorización
chat.bot
. - Llama al
Método
get
en la RecursoAttachment
, - Pasa el
name
del archivo adjunto del mensaje.
Para obtener los metadatos del archivo adjunto de un mensaje, sigue estos pasos:
Python
- En tu directorio de trabajo, crea un archivo llamado
chat_get_message_attachment.py
Incluye el siguiente código en
chat_get_message_attachment.py
:from google.oauth2 import service_account from apiclient.discovery import build # Specify required scopes. SCOPES = ['https://www.googleapis.com/auth/chat.bot'] # Specify service account details. CREDENTIALS = ( service_account.Credentials.from_service_account_file('credentials.json') .with_scopes(SCOPES) ) # Build the URI and authenticate with the service account. chat = build('chat', 'v1', credentials=CREDENTIALS) # Get a Chat message. result = chat.spaces().messages().attachments().get( # The message 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 MESSAGE with a message name. # Obtain the message name from the response body returned # after creating a message asynchronously with Chat REST API. name='spaces/SPACE/messages/MESSAGE/attachments/ATTACHMENT' ).execute() # Print Chat API's response in your command line interface. print(result)
En el código, reemplaza
spaces/SPACE/messages/MESSAGE/attachments/ATTACHMENT
con el nombre del archivo adjunto del mensaje.En tu directorio de trabajo, compila y ejecuta la muestra:
python3 chat_get_message_attachment.py
La API de Chat devuelve una instancia de
Attachment
que detalla los metadatos acerca del archivo adjunto del mensaje especificado.
Temas relacionados
- Cómo subir contenido multimedia como archivo adjunto
- Cómo descargar contenido multimedia como un archivo adjunto