Method: spaces.messages.delete

Exclui uma mensagem. Para conferir um exemplo, consulte Excluir uma mensagem.

Oferece suporte aos seguintes tipos de autenticação:

  • Autenticação do app com o escopo de autorização:

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

  • Autenticação do usuário com um dos seguintes escopos de autorização:

    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (somente espaços do modo de importação)

Ao usar a autenticação de app, as solicitações só podem excluir mensagens criadas pelo app de chat que faz a chamada.

Solicitação HTTP

DELETE https://chat.googleapis.com/v1/{name=spaces/*/messages/*}

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. Nome do recurso da mensagem.

Formato: spaces/{space}/messages/{message}

Se você definiu um ID personalizado para a mensagem, use o valor do campo clientAssignedMessageId para {message}. Confira mais detalhes em Nomear uma mensagem.

Parâmetros de consulta

Parâmetros
force

boolean

Opcional. Quando true, a exclusão de uma mensagem também exclui as respostas em linha dela. Quando false, se uma mensagem tiver respostas em uma conversa, a exclusão falhará.

Aplicável apenas quando a autenticação é feita como um usuário. Não tem efeito ao autenticação como um app de chat.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta será um objeto JSON vazio.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte o guia de autorização.