- 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 de um espaço de que o autor da chamada participa, inclusive as de participantes e espaços bloqueados. Se você listar mensagens de um espaço sem mensagens, a resposta será um objeto vazio. Ao usar uma interface REST/HTTP, a resposta contém um objeto JSON vazio, {}
. Para ver um exemplo, consulte Listar mensagens. Exige 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 para listar 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, no máximo 25 são retornados. O valor máximo é 1.000. Se você usar um valor maior que 1.000, ele será alterado automaticamente para 1.000. Valores negativos retornam um erro |
pageToken |
Opcional, se estiver reiniciando 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 subsequente. Ao paginar, todos os outros parâmetros fornecidos devem corresponder à chamada que forneceu o token da página. Passar 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 as 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:
As consultas inválidas são rejeitadas pelo servidor com um erro |
orderBy |
Opcional, se estiver reiniciando de uma consulta anterior. Como a lista de mensagens é ordenada. Especifique um valor a ser ordenado por uma operação de ordenação. Os valores de operação de ordenação válidos são os seguintes:
A ordem padrão é |
showDeleted |
Define se as mensagens excluídas serão incluídas. As mensagens excluídas incluem o horário da exclusão e os metadados sobre a exclusão, mas o conteúdo da mensagem não está disponível. |
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Mensagem de resposta para listar mensagens.
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 do 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.