En esta guía, se explica cómo usar el método delete()
en el recurso Message
de la API de Google Chat para borrar un mensaje de texto o de tarjeta.
En la API de Chat, un mensaje de Chat se representa 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 mostrar interfaces de usuario estáticas o interactivas, recopilar información de los usuarios y entregar 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 la app, puedes usar este método para borrar un mensaje que envió la app de Chat. Con la autenticación del usuario, puedes usar este método para borrar un mensaje que envió el usuario autenticado. Si el usuario es administrador del espacio, es posible que también puedas borrar un mensaje que enviaron otros miembros del espacio. Para obtener más información, consulta Obtén información sobre tu rol como administrador de un espacio.
Requisitos previos
Node.js
- Una cuenta empresarial o empresarial 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 la biblioteca cliente de Cloud para Node.js.
- 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,
crea credenciales de cuenta de servicio y guárdalas como un archivo JSON con el nombre
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 permiso de autorización según si quieres autenticarte como usuario o como la app de Chat.
Python
- Una cuenta empresarial o empresarial 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 la biblioteca cliente de Cloud de Python.
- Crea credenciales de acceso según cómo quieras 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, crea las credenciales de la cuenta de servicio y guárdalas 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 permiso de autorización según si quieres autenticarte como usuario o como la app de Chat.
Java
- Una cuenta empresarial o empresarial 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 la biblioteca cliente de Cloud para Java.
- 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,
crea credenciales de cuenta de servicio y guárdalas como un archivo JSON con el nombre
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 quieres autenticarte como usuario o como la app de Chat.
Apps Script
- Una cuenta de Google Workspace para empresas o empresas 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 de usuario o de 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 permiso de autorización según si quieres autenticarte como usuario o como la app de Chat.
Borra un mensaje con autenticación de usuario
Para borrar un mensaje con autenticación de 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 delname
del espacio. 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.
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 app
Para borrar 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
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 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.
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
- Hacer una lista de mensajes en un espacio
- Actualiza un mensaje.
- Envíeles un mensaje.