En esta guía, se explica cómo usar el método get()
en el recurso Message
de la API de Google Chat para mostrar detalles sobre un mensaje de texto o de tarjeta.
En la API de Chat, los mensajes de Chat se representan con el
Recurso Message
.
Si bien los usuarios de Chat solo pueden enviar mensajes que contengan texto
Las apps de Chat pueden usar muchas otras funciones de mensajería, como las siguientes:
mostrar interfaces de usuario estáticas o interactivas, recopilar información de
usuarios y la entrega de mensajes de forma privada. Para obtener más información sobre las funciones de mensajería disponibles para la API de Chat, consulta la descripción general de los mensajes de Google Chat.
Requisitos previos
Node.js
- 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, un ícono y una descripción para tu app de Chat.
- Instala el Node.js Biblioteca cliente de Cloud.
- Crea credenciales de acceso según la forma en que deseas autenticarte en tu solicitud a la API de Google Chat:
- Sigue estos pasos para autenticarte como usuario de Chat:
crear un ID de cliente de OAuth
credenciales y las guarda como un archivo JSON llamado
client_secrets.json
a tu directorio local. - Para autenticarte como la app de Chat,
crea credenciales de cuenta de servicio y guárdalas como un archivo JSON con el nombre
credentials.json
.
- Sigue estos pasos para autenticarte como usuario de Chat:
crear un ID de cliente de OAuth
credenciales y las guarda como un archivo JSON llamado
- Elige un alcance de autorización según si deseas autenticarte como usuario o como la app de Chat.
- Un espacio de Google Chat del que sea miembro el usuario autenticado o la app de Chat que realiza la llamada. Para autenticarse como App de Chat, agrega el App de Chat al espacio
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.
- Instala el Python Biblioteca cliente de Cloud.
- Crea credenciales de acceso según la forma en que deseas autenticarte en tu solicitud a la API de Google Chat:
- Sigue estos pasos para autenticarte como usuario de Chat:
crear un ID de cliente de OAuth
credenciales y las guarda como un archivo JSON llamado
client_secrets.json
a tu directorio local. - Para autenticarte como la app de Chat,
crea credenciales de cuenta de servicio y guárdalas como un archivo JSON con el nombre
credentials.json
.
- Sigue estos pasos para autenticarte como usuario de Chat:
crear un ID de cliente de OAuth
credenciales y las guarda como un archivo JSON llamado
- Elige un alcance de autorización en función de si deseas autenticarte como usuario o App de Chat
- Un espacio de Google Chat en el que el usuario autenticado o que llamar a la app de Chat es miembro. Para autenticarse como App de Chat, agrega el App de Chat al espacio
Java
- 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, un ícono y una descripción para tu app de Chat.
- Instala el Java Biblioteca cliente de Cloud.
- Crea credenciales de acceso según cómo quieras autenticarte en tu API de Google Chat
solicitud:
- Sigue estos pasos para autenticarte como usuario de Chat:
crear un ID de cliente de OAuth
credenciales y las guarda como un archivo JSON llamado
client_secrets.json
a tu directorio local. - Para autenticarte como la app de Chat,
crea credenciales de cuenta de servicio y guárdalas como un archivo JSON con el nombre
credentials.json
.
- Sigue estos pasos para autenticarte como usuario de Chat:
crear un ID de cliente de OAuth
credenciales y las guarda como un archivo JSON llamado
- Elige un alcance de autorización en función de si deseas autenticarte como usuario o App de Chat
- Un espacio de Google Chat del que sea miembro el usuario autenticado o la app de Chat que realiza la llamada. Para autenticarte como la app de Chat, agrégala al espacio.
Apps Script
- Una cuenta de Google Workspace para empresas o negocios 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, un ícono y una descripción para tu app de Chat.
- Crea un proyecto independiente de Apps Script y activa el servicio de Chat avanzado.
- En esta guía, debes usar la autenticación del usuario o de la app. Para autenticar como la app de Chat, crea credenciales de cuenta de servicio. Para conocer los pasos, consulta Autentícate y autoriza como una app de Google Chat.
- Elige un alcance de autorización según si deseas autenticarte como usuario o como la app de Chat.
- Un espacio de Google Chat en el que el usuario autenticado o que llamar a la app de Chat es miembro. Para autenticarte como la app de Chat, agrégala al espacio.
Recibe un mensaje con la autenticación de usuario
Para obtener detalles sobre un mensaje con autenticación de usuarios, pasa lo siguiente en tu solicitud:
- Especifica el alcance de autorización
chat.messages.readonly
ochat.messages
. - Realiza una llamada al método
GetMessage()
. - Establece
name
en el nombre del recurso del mensaje que se obtendrá.
En el siguiente ejemplo, se recibe un mensaje con Autenticación de usuarios:
Node.js
Python
Java
Apps Script
Para ejecutar esta muestra, reemplaza lo siguiente:
SPACE_NAME
: Es el ID del espacio.name
Para obtener el ID, llama al métodoListSpaces()
o desde la URL del espacio.MESSAGE_NAME
: Es el ID delname
del mensaje. Puedes obtener el ID del cuerpo de la respuesta que se muestra después de crear un mensaje de forma asíncrona con la API de Chat o con el nombre personalizado asignado al mensaje en el momento de su creación.
La API de Chat devuelve una instancia de
Message
que detalla el mensaje especificado.
Cómo recibir un mensaje con la autenticación de la app
Para obtener detalles sobre un mensaje con autenticación de apps, pasa lo siguiente en tu solicitud:
- Especifica el alcance de la autorización
chat.bot
. - Realiza una llamada al método
GetMessage()
. - Establece
name
en el nombre del recurso del mensaje que se obtendrá.
En el siguiente ejemplo, se recibe un mensaje con Autenticación de la app:
Node.js
Python
Java
Apps Script
Para ejecutar esta muestra, reemplaza lo siguiente:
SPACE_NAME
: Es el ID delname
del espacio. Para obtener el ID, llama al métodoListSpaces()
o desde la URL del espacio.MESSAGE_NAME
: El ID del mensajename
Puedes obtener el ID del cuerpo de la respuesta que se muestra después de crear un de forma asíncrona con la API de Chat nombre personalizado se asigna al mensaje en el momento de su creación.
La API de Chat devuelve una instancia de
Message
que detalla el mensaje especificado.
Temas relacionados
- Dar formato a un mensaje.
- Borrar un mensaje.
- Crea una lista de los mensajes de un espacio.
- Actualiza un mensaje.
- Envíeles un mensaje.