- Solicitação HTTP
- Parâmetros de caminho
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Faça um teste
Lista as mensagens em um espaço de que o autor da chamada participa, inclusive as de participantes e espaços bloqueados. Veja um exemplo em Listar mensagens. Requer a autenticação do usuário.
Solicitação HTTP
GET https://chat.googleapis.com/v1/{parent=spaces/*}/messages
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
parent |
Obrigatório. O nome do recurso do espaço do qual listar as mensagens. Formato: |
Parâmetros de consulta
Parâmetros | |
---|---|
pageSize |
O número máximo de mensagens retornadas. O serviço pode retornar menos mensagens do que esse valor. Se não for especificado, serão retornadas no máximo 25. O valor máximo é 1.000. Se você usar um valor maior que 1.000, ele vai ser automaticamente alterado para 1.000. Valores negativos retornam um erro |
pageToken |
Opcional se estiver retomando de uma consulta anterior. Um token de página recebido de uma chamada de mensagens de lista anterior. Forneça esse parâmetro para recuperar a página seguinte. Ao fazer a paginação, todos os outros parâmetros informados precisam corresponder à chamada que forneceu o token da página. Transmitir valores diferentes para outros parâmetros pode levar a resultados inesperados. |
filter |
Um filtro de consulta. Você pode filtrar as mensagens por data ( Para filtrar mensagens pela data de criação, especifique o Para filtrar por linha de execução, especifique o Para filtrar por linha de execução e data, use o operador Por exemplo, as seguintes consultas são válidas:
Consultas inválidas são rejeitadas pelo servidor com um erro |
orderBy |
Opcional se estiver retomando de uma consulta anterior. Como a lista de mensagens é ordenada. Especifique um valor para ordenar por uma operação de ordenação. Estes são os valores válidos de operação de ordenação:
A ordem padrão é |
showDeleted |
Define se as mensagens excluídas serão incluídas. As mensagens excluídas incluem a hora e os metadados excluídos sobre a exclusão, mas o conteúdo delas fica indisponível. |
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Mensagem de resposta para mensagens de listagem.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Representação JSON |
---|
{
"messages": [
{
object ( |
Campos | |
---|---|
messages[] |
Lista de mensagens. |
nextPageToken |
É possível enviar um token como |
Escopos de autorização
Requer um dos seguintes escopos de OAuth:
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.readonly
Para mais informações, consulte o Guia de autorização.