Method: users.sections.list

Lista as seções disponíveis para o usuário do Chat. As seções ajudam os usuários a agrupar as conversas e personalizar a lista de espaços exibida no painel de navegação do Chat. Saiba mais em Criar e organizar seções no Google Chat.

Exige autenticação do usuário com o escopo de autorização:

  • https://www.googleapis.com/auth/chat.users.sections
  • https://www.googleapis.com/auth/chat.users.sections.readonly

Solicitação HTTP

GET https://chat.googleapis.com/v1/{parent=users/*}/sections

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O pai, que é o nome do recurso de usuário proprietário dessa coleção de seções. Só é possível listar seções para o usuário que fez a chamada. Para se referir ao usuário que está fazendo a chamada, defina uma das seguintes opções:

  • O alias me. Por exemplo, users/me.

  • O endereço de e-mail do Workspace. Por exemplo, users/user@example.com.

  • O ID do usuário. Por exemplo, users/123456789.

Formato: users/{user}

Parâmetros de consulta

Parâmetros
pageSize

integer

Opcional. O número máximo de seções a serem retornadas. O serviço pode retornar um valor inferior a este.

Se não for especificado, no máximo 10 seções serão retornadas.

O valor máximo é 100. Se você usar um valor maior que 100, ele será mudado automaticamente para 100.

Valores negativos retornam um erro INVALID_ARGUMENT.
pageToken

string

Opcional. Um token de página recebido de uma chamada "list sections" anterior. Forneça isso para recuperar a página subsequente.

Na paginação, todos os outros parâmetros fornecidos precisam corresponder à chamada que forneceu o token da página. Transmitir valores diferentes aos outros parâmetros pode gerar resultados inesperados.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Mensagem de resposta para listar seções.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

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

object (Section)

As seções do usuário especificado.
nextPageToken

string

Um token, que pode ser enviado como pageToken para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/chat.users.sections
  • https://www.googleapis.com/auth/chat.users.sections.readonly

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