Method: users.sections.items.list

Elenca gli elementi in una sezione.

Al momento, solo gli spazi possono essere elementi della sezione. Per maggiori dettagli, vedi Creare e organizzare sezioni in Google Chat.

Richiede l'autenticazione utente con l'ambito di autorizzazione:

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

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il genitore, ovvero il nome della risorsa della sezione proprietaria di questa raccolta di elementi della sezione. Supporta solo gli elementi della sezione dell'elenco per l'utente chiamante.

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

Parametri di query

Parametri
pageSize

integer

Facoltativo. Il numero massimo di elementi della sezione da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore.

Se non specificato, verranno restituiti al massimo 10 elementi della sezione.

Il valore massimo è 100. Se utilizzi un valore superiore a 100, questo viene automaticamente modificato in 100.

I valori negativi restituiscono un errore INVALID_ARGUMENT.
pageToken

string

Facoltativo. Un token di pagina ricevuto da una precedente chiamata di elementi della sezione dell'elenco. Forniscilo per recuperare la pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti devono corrispondere alla chiamata che ha fornito il token di pagina. Il passaggio di valori diversi agli altri parametri potrebbe portare a risultati imprevisti.
filter

string

Facoltativo. Un filtro query.

Al momento supporta solo il filtro per spazio.

Ad esempio, space = spaces/{space}.

Le query non valide vengono rifiutate con un errore INVALID_ARGUMENT.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per gli elementi della sezione Elenco.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "sectionItems": [
    {
      object (SectionItem)
    }
  ],
  "nextPageToken": string
}
Campi
sectionItems[]

object (SectionItem)

Gli elementi della sezione specificata.
nextPageToken

string

Un token, che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.