Method: spaces.messages.delete

Borra un mensaje. Para ver un ejemplo, consulta Cómo borrar un mensaje.

Admite los siguientes tipos de autenticación:

  • Autenticación de la app con el alcance de autorización:

    • https://www.googleapis.com/auth/chat.bot

  • Autenticación de usuarios con uno de los siguientes permisos de autorización:

    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (solo espacios del modo de importació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.