Method: spaces.list

Lista os espaços de que o autor da chamada faz parte. Os bate-papos em grupo e as mensagens diretas só são listados depois que a primeira mensagem é enviada. Para ver um exemplo, consulte Listar espaços.

Requer autenticação. É totalmente compatível com a autenticação da conta de serviço, e a autenticação do usuário exige o escopo de autorização chat.spaces ou chat.spaces.readonly.

Lista os espaços visíveis para o autor da chamada ou o usuário autenticado. Os bate-papos em grupo e as mensagens diretas só são listados depois que a primeira mensagem é enviada.

Solicitação HTTP

GET https://chat.googleapis.com/v1/spaces

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

Parâmetros de consulta

Parâmetros
pageSize

integer

Opcional. O número máximo de espaços a serem retornados. O serviço pode retornar menos que esse valor.

Se não for especificado, serão retornados no máximo 100 espaços.

O valor máximo é 1.000. Se você usar um valor acima de 1.000, ele será automaticamente alterado para 1.000.

Valores negativos retornam um erro INVALID_ARGUMENT.
pageToken

string

Opcional. Um token de página, recebido de uma chamada de espaços de lista anterior. Forneça esse parâmetro para recuperar a página subsequente.

Ao paginar, o valor do filtro deve corresponder à chamada que forneceu o token da página. Passar um valor diferente pode levar a resultados inesperados.
filter

string

Opcional. Um filtro de consulta.

Requer a autenticação do usuário.

Você pode filtrar os tipos por espaço (spaceType).

Para filtrar por tipo de espaço, especifique um valor de enumeração válido, como SPACE ou GROUP_CHAT. O spaceType não pode ser SPACE_TYPE_UNSPECIFIED. Para consultar vários tipos de espaço, use o operador OR.

Por exemplo, as seguintes consultas são válidas:

spaceType = "SPACE"
spaceType = "GROUP_CHAT" OR spaceType = "DIRECT_MESSAGE"

Consultas inválidas são rejeitadas pelo servidor com um erro INVALID_ARGUMENT.

Com a autenticação da conta de serviço, esse campo é ignorado e a consulta sempre retorna todos os espaços. Como a API Chat ainda valida a sintaxe da consulta com as contas de serviço, as consultas inválidas ainda são rejeitadas.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se bem-sucedido, o corpo da resposta exibirá os dados com a seguinte estrutura:

Representação JSON 
{
  "spaces": [
    {
      object (Space)
    }
  ],
  "nextPageToken": string
}
Campos
spaces[]

object (Space)

Lista de espaços na página solicitada (ou primeira).
nextPageToken

string

Você pode enviar um token como pageToken para recuperar a próxima página de resultados. Se estiver vazio, não haverá páginas subsequentes.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

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

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