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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il parent, ovvero il nome della risorsa utente proprietaria di questa raccolta di sezioni. Supporta solo l'elenco delle sezioni per l'utente chiamante. Per fare riferimento all'utente chiamante, imposta uno dei seguenti:

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

  • Il suo indirizzo email di 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 modificato automaticamente 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.

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.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per l'elenco delle sezioni.

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.