Excluir uma mensagem (original) (raw)

Este guia explica como usar o métododelete()no recurso Message da API Google Chat para excluir uma mensagem de texto ou cartão.

Na API Chat, uma mensagem do Chat é representada pelo recurso Message. Os usuários do Chat só podem enviar mensagens de texto, mas os apps do Chat podem usar muitos outros recursos de mensagens, incluindo mostrar interfaces de usuário estáticas ou interativas, coletar informações dos usuários e enviar mensagens particulares. Para saber mais sobre os recursos de mensagens disponíveis para a API Chat, consulte a visão geral das mensagens do Google Chat.

Com a autenticação de app, você pode usar esse método para excluir uma mensagem enviada pelo app Chat. Com aautenticação de usuário, você pode usar esse método para excluir uma mensagem enviada pelo usuário autenticado. Se o usuário for administrador do espaço, talvez você também possa excluir uma mensagem enviada por outros participantes. Para mais informações, consulte Saiba mais sobre sua função como administrador do espaço.

Pré-requisitos

Node.js

Uma conta do Google Workspace Business ou Enterprise com acesso ao Google Chat.
Configure seu ambiente:
- Crie um projeto do Google Cloud.
- Configure a tela de permissão OAuth.
- Ative e configure a API Google Chat com um nome, ícone e descrição para seu app do Chat.
- Instale a biblioteca de cliente do Cloud do Node.js.
- Crie credenciais de acesso com base na forma como você quer fazer a autenticação na solicitação da API Google Chat:
  * Para autenticar como um usuário do Chat,crie credenciais de ID do cliente OAuth e salve-as como um arquivo JSON chamadocredentials.json no seu diretório local.
  * Para autenticar como o app Chat,crie credenciais de conta de serviço e salve-as como um arquivo JSON chamadocredentials.json.
Escolha um escopo de autorização com base em se você quer autenticar como um usuário ou o app Chat.

Python

Uma conta do Google Workspace Business ou Enterprise com acesso ao Google Chat.
Configure seu ambiente:
- Crie um projeto do Google Cloud.
- Configure a tela de permissão OAuth.
- Ative e configure a API Google Chat com um nome, ícone e descrição para seu app do Chat.
- Instale a biblioteca de cliente do Cloud Python.
- Crie credenciais de acesso com base na forma como você quer fazer a autenticação na solicitação da API Google Chat:
  * Para autenticar como um usuário do Chat,crie credenciais de ID do cliente OAuth e salve-as como um arquivo JSON chamadocredentials.json no seu diretório local.
  * Para autenticar como o app Chat,crie credenciais de conta de serviço e salve-as como um arquivo JSON chamadocredentials.json.
Escolha um escopo de autorização com base em se você quer autenticar como um usuário ou o app Chat.

Java

Uma conta do Google Workspace Business ou Enterprise com acesso ao Google Chat.
Configure seu ambiente:
- Crie um projeto do Google Cloud.
- Configure a tela de permissão OAuth.
- Ative e configure a API Google Chat com um nome, ícone e descrição para seu app do Chat.
- Instale a biblioteca de cliente do Cloud para Java.
- Crie credenciais de acesso com base na forma como você quer fazer a autenticação na solicitação da API Google Chat:
  * Para autenticar como um usuário do Chat,crie credenciais de ID do cliente OAuth e salve-as como um arquivo JSON chamadocredentials.json no seu diretório local.
  * Para autenticar como o app Chat,crie credenciais de conta de serviço e salve-as como um arquivo JSON chamadocredentials.json.
Escolha um escopo de autorização com base em se você quer autenticar como um usuário ou o app Chat.

Apps Script

Uma conta do Google Workspace Business ou Enterprise com acesso ao Google Chat.
Configure seu ambiente:
- Crie um projeto do Google Cloud.
- Configure a tela de permissão OAuth.
- Ative e configure a API Google Chat com um nome, ícone e descrição para seu app do Chat.
- Crie um projeto independente do Apps Script e ative o Serviço avançado de chat.
- Neste guia, você precisa usar a autenticação de usuário ou de app. Para autenticar como o app Chat, crie credenciais de conta de serviço. Para ver as etapas, consulteAutenticar e autorizar como um app do Google Chat.
Escolha um escopo de autorização com base em se você quer autenticar como um usuário ou o app Chat.

Excluir uma mensagem com autenticação do usuário

Para excluir uma mensagem com autenticação do usuário, transmita o seguinte na sua solicitação:

Especifique o escopo de autorização chat.messages.
Chame o método DeleteMessage().
Defina name como o nome do recurso da mensagem a ser excluída.

O exemplo a seguir exclui uma mensagem comautenticação do usuário:

Node.js

Python

Java

Apps Script

Para executar esta amostra, substitua o seguinte:

SPACE_NAME: o ID doname do espaço. Você pode conseguir o ID chamando o métodoListSpaces() ou no URL do espaço.
MESSAGE_NAME: o ID do name da mensagem. É possível receber o ID do corpo da resposta retornado após a criação de uma mensagem de forma assíncrona com a API Chat ou com o nome personalizado atribuído à mensagem na criação.

Se a operação for bem-sucedida, o corpo da resposta vai estar vazio, o que indica que a mensagem foi excluída.

Excluir uma mensagem com autenticação do app

Para excluir uma mensagem comautenticação do app, transmita o seguinte na sua solicitação:

Especifique o escopo de autorização chat.bot.
Chame o método DeleteMessage().
Defina name como o nome do recurso da mensagem a ser excluída.

O exemplo a seguir exclui uma mensagem comautenticação do app:

Node.js

Python

Java

Apps Script

Para executar esta amostra, substitua o seguinte:

SPACE_NAME: o ID doname do espaço. Você pode conseguir o ID chamando o métodoListSpaces() ou no URL do espaço.
MESSAGE_NAME: o ID do name da mensagem. É possível receber o ID do corpo da resposta retornado após a criação de uma mensagem de forma assíncrona com a API Chat ou com onome personalizado atribuído à mensagem na criação.

Se a operação for bem-sucedida, o corpo da resposta vai estar vazio, o que indica que a mensagem foi excluída.