Method: spaces.messages.delete
Borra un mensaje. Para ver un ejemplo, consulta Cómo borrar un mensaje.
Admite los siguientes tipos de autenticación:
Cuando se usa la autenticación de apps, las solicitudes solo pueden borrar los mensajes creados por la app de Chat que realiza la llamada.
Solicitud HTTP
DELETE https://chat.googleapis.com/v1/{name=spaces/*/messages/*}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros |
name |
string
Obligatorio. Es el nombre del recurso del mensaje. Formato: spaces/{space}/messages/{message} Si estableciste un ID personalizado para tu mensaje, puedes usar el valor del campo clientAssignedMessageId para {message} . Para obtener más información, consulta Cómo asignar un nombre a un mensaje.
|
Parámetros de consulta
Parámetros |
force |
boolean
Opcional. Cuando true , borrar un mensaje también borra sus respuestas en el subproceso. Cuando false , si un mensaje tiene respuestas en una conversación, la eliminación falla. Solo se aplica cuando se autentica como usuario. No tiene efecto cuando se autentica como una app de chat.
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta correctamente, el cuerpo de la respuesta es un objeto JSON vacío.
Permisos de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.messages
Para obtener más información, consulta la Guía de autorización.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-01-22 (UTC)
[null,null,["Última actualización: 2025-01-22 (UTC)"],[[["This method enables you to delete messages and optionally their replies using an HTTP DELETE request."],["It supports both app and user authentication, with app authentication limiting deletion to messages created by the app."],["You can specify whether to force delete threaded replies with the `force` query parameter when using user authentication."],["The request requires specifying the message's resource name in the URL path and an empty request body."],["Authorization is required using one of the specified OAuth scopes."]]],["This document details how to delete a message using the Chat API. The `DELETE` request targets a specific message's resource name in the format `spaces/*/messages/*`. It supports both app and user authentication, with different limitations for each. The request requires a message's name as a path parameter. A `force` query parameter is optional for user authentication to delete threaded replies. The request body is empty, and a successful response returns an empty JSON object. One of three specified OAuth scopes is required.\n"]]