En esta guía, se explica cómo usar la
delete()
en el recurso Message
de la API de Google Chat para borrar un texto o una tarjeta
mensaje.
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.
Con la autenticación de apps, puedes usar este método para borrar un mensaje que envió la app de Chat. Con autenticación de usuarios, puede usar este método para borrar un mensaje que envió el usuario autenticado. Si usuario es administrador del espacio, es posible que también puedas borrar mensaje que enviaron otros miembros del espacio. Para obtener más información, consulta Información sobre tu rol como administrador del espacio.
Requisitos previos
Node.js
- 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.
- 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 en función de si deseas autenticarte como usuario o App de Chat
Python
- 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. y la descripción de tu app de Chat.
- Instala la biblioteca cliente de Cloud de Python.
- 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, sigue estos pasos:
crear cuenta de servicio
credenciales y las guarda como un archivo JSON llamado
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
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 la forma en que deseas autenticarte en tu solicitud a la API de Google Chat:
- Para autenticarte como usuario de Chat,
crea credenciales de ID de cliente de
OAuth y guárdalas como un archivo JSON llamado
client_secrets.json
en tu directorio local. - Para autenticarte como la app de Chat, sigue estos pasos:
crear cuenta de servicio
credenciales y las guarda como un archivo JSON llamado
credentials.json
- Para autenticarte como usuario de Chat,
crea credenciales de ID de cliente de
OAuth y guárdalas como un archivo JSON llamado
- Elige un alcance de autorización según si deseas autenticarte como usuario o como la app de Chat.
Apps Script
- 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.
- Crear un proyecto independiente de Apps Script, y activa el Servicio de chat avanzado.
- En esta guía, debes usar las funciones o autenticación de apps. Para autenticarte como la app de Chat, crea las credenciales de la cuenta de servicio. Para ver los pasos, consulta Autentícate y autoriza app de Google Chat
- Elige un alcance de autorización según si deseas autenticarte como usuario o como la app de Chat.
Borra un mensaje con autenticación de usuario
Para borrar un mensaje con autenticación del usuario, pasa lo siguiente en tu solicitud:
- Especifica el alcance de autorización de
chat.messages
. - Realiza una llamada al método
DeleteMessage()
. - Establece
name
en el nombre del recurso del mensaje que se borrará.
En el siguiente ejemplo, se borra un mensaje con autenticación del usuario:
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 alListSpaces()
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 de forma asíncrona con la API de Chat nombre personalizado se asigna al mensaje en el momento de su creación.
Si se ejecuta de forma correcta, el cuerpo de la respuesta estará vacío, lo que indica que el mensaje se borró.
Borra un mensaje con autenticación de la app
Para borrar un mensaje con autenticación de app, pasa el siguiente en tu solicitud:
- Especifica el alcance de la autorización
chat.bot
. - Realiza una llamada al método
DeleteMessage()
. - Establece
name
en el nombre del recurso del mensaje que se borrará.
En el siguiente ejemplo, se borra un mensaje con autenticación de apps:
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 alListSpaces()
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 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.
Si se ejecuta de forma correcta, el cuerpo de la respuesta estará vacío, lo que indica que el mensaje se borró.
Temas relacionados
- Dar formato a un mensaje.
- Obtener detalles sobre un mensaje
- Crea una lista de los mensajes de un espacio.
- Actualiza un mensaje.
- Envíeles un mensaje.