Method: users.sections.list

Elenca le sezioni disponibili per l'utente di Chat. Le sezioni aiutano gli utenti a raggruppare le conversazioni e a personalizzare l'elenco degli spazi visualizzati nel pannello di navigazione di Chat. 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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il genitore, ovvero il nome della risorsa utente proprietaria di questa raccolta di sezioni. Supporta solo le sezioni degli elenchi per l'utente che chiama. Per fare riferimento all'utente chiamante, imposta uno dei seguenti valori:

  • L'alias me. Ad esempio, users/me.

  • Il suo indirizzo email Workspace. Ad esempio, users/user@example.com.

  • Il suo ID utente. Ad esempio, users/123456789.

Formato: users/{user}

Parametri di query

Parametri
pageSize

integer

Facoltativo. Il numero massimo di sezioni da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore.

Se non specificato, verranno restituite al massimo 10 sezioni.

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 dell'elenco delle sezioni. 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.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per le sezioni delle schede.

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

Rappresentazione JSON 
{
  "sections": [
    {
      object (Section)
    }
  ],
  "nextPageToken": string
}
Campi
sections[]

object (Section)

Le sezioni dell'utente specificato.
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.