Este guia explica como usar o
list()
método no recurso Message
da API Google Chat para conferir uma
lista filtrável de mensagens em um espaço.
Na API Chat, uma mensagem é representada pelo
recurso Message
.
Os usuários do Chat só podem enviar mensagens com texto,
Os apps de chat podem usar vários outros recursos de mensagens, incluindo
exibir interfaces do usuário estáticas ou interativas, coletar informações de
usuários e na entrega de mensagens com privacidade. Para saber mais sobre os recursos de mensagens
disponíveis para a API Chat, consulte a
Visão geral das mensagens do Google Chat.
Pré-requisitos
Node.js
- Uma conta do Google Workspace para empresas ou empresas com acesso ao Google Chat.
- Configure o ambiente:
- Crie um projeto do Google Cloud.
- Configure a tela de consentimento OAuth.
- Ative e configure a API Google Chat com um nome. o ícone e a descrição do app do Chat.
- Instale a biblioteca de cliente do Cloud para Node.js.
-
Criar credenciais de ID do cliente OAuth para um aplicativo para computador. Para executar o exemplo neste
guia, salve as credenciais como um arquivo JSON chamado
client_secrets.json
no seu diretório local.
- Escolha um escopo de autorização que ofereça suporte à autenticação de usuários.
- Um espaço do Google Chat. Para criar um grupo usando a API Google Chat, consulte Criar um espaço. Para criar uma no Chat: acesse documentação da Central de Ajuda.
Python
- Uma conta do Google Workspace para empresas ou empresas com acesso ao Google Chat.
- Configure o ambiente:
- Crie um projeto do Google Cloud.
- Configure a tela de consentimento OAuth.
- Ative e configure a API Google Chat com um nome. o ícone e a descrição do app do Chat.
- Instale a biblioteca de cliente do Cloud para Python.
-
Criar credenciais de ID do cliente OAuth para um aplicativo para computador. Para executar o exemplo
salve as credenciais como um arquivo JSON chamado
client_secrets.json
em seu no diretório local.
- Escolha um escopo de autorização que ofereça suporte à autenticação de usuários.
- Um espaço do Google Chat. Para criar um usando a API Google Chat, consulte Criar um espaço. Para criar uma no Chat: acesse documentação da Central de Ajuda.
Java
- Uma empresa Conta do Google Workspace com acesso a Google Chat.
- Configure o 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 o Java biblioteca de cliente do Cloud.
-
Criar credenciais de ID do cliente OAuth para um aplicativo para computador. Para executar o exemplo
salve as credenciais como um arquivo JSON chamado
client_secrets.json
em seu no diretório local.
- Escolha um escopo de autorização que ofereça suporte à autenticação de usuários.
- Um espaço do Google Chat. Para criar um usando a API Google Chat, consulte Criar um espaço. Para criar uma no Chat: acesse documentação da Central de Ajuda.
Apps Script
- Uma empresa Conta do Google Workspace com acesso a Google Chat.
- Configure o 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.
- Escolha um escopo de autorização que ofereça suporte à autenticação de usuários.
- Um espaço do Google Chat. Para criar um usando a API Google Chat, consulte Criar um espaço. Para criar uma no Chat, acesse a documentação da Central de Ajuda.
Listar mensagens
Para listar mensagens com autenticação do usuário transmita o seguinte na sua solicitação:
- Especifique o escopo de autorização
chat.messages.readonly
ouchat.messages
. - Chame o método
ListMessages()
.
Este exemplo lista as mensagens em um espaço do Chat:
Node.js
Python
Java
Apps Script
Para executar esta amostra, substitua SPACE_NAME
pelo ID de
do espaço
name
. Para conseguir o ID, chame o método
ListSpaces()
ou o URL do espaço.
A API Chat retorna uma
lista de mensagens
enviados no espaço especificado. Se não houver mensagens da solicitação, a
resposta da API Chat vai retornar um objeto vazio. Ao usar uma interface REST/HTTP, a resposta contém um objeto JSON vazio, {}
.
Temas relacionados
- Formatar uma mensagem.
- Excluir uma mensagem.
- Conferir detalhes sobre uma mensagem.
- Atualizar uma mensagem.
- Enviar uma mensagem.