Method: users.sections.items.list

Elenca gli elementi in una sezione.

Solo gli spazi possono essere elementi della sezione. Per i dettagli, consulta Creare e organizzare le sezioni in Google Chat.

Richiede l'autenticazione dell'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 parent, ovvero il nome della risorsa della sezione che possiede questa raccolta di elementi della sezione. Supporta solo l'elenco degli elementi della sezione per l'utente chiamante.

Quando filtri per spazio, utilizza il carattere jolly - per eseguire la ricerca in tutte le sezioni. Ad esempio, users/{user}/sections/-.

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 valore inferiore a questo.

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

Il valore massimo è 100. Se utilizzi un valore superiore a 100, questo viene modificato automaticamente 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.

Quando esegui 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 di 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 l'elenco degli elementi della sezione.

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 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.