Method: users.sections.items.list

Lista os itens em uma seção.

No momento, apenas espaços podem ser itens de seção. 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/*}/items

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 da seção proprietária dessa coleção de itens da seção. Só é possível listar itens da seção para o usuário que fez a chamada.

Formato: users/{user}/sections/{section}

Parâmetros de consulta

Parâmetros
pageSize

integer

Opcional. O número máximo de itens da seção a serem retornados. O serviço pode retornar um valor inferior a este.

Se não for especificado, no máximo 10 itens de seção serão retornados.

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 section items" 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.
filter

string

Opcional. Um filtro de consulta.

No momento, só é possível filtrar por espaço.

Por exemplo, space = spaces/{space}.

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

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Mensagem de resposta para listar itens da seção.

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

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

object (SectionItem)

Os itens da seção especificada.
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.