Method: roles.list

Recupera un elenco paginato di tutti i ruoli in un dominio.

Richiesta HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/roles

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customer

string

L'ID univoco dell'account Google Workspace del cliente. In caso di un account multidominio, per recuperare tutti i gruppi di un cliente, utilizza questo campo anziché domain. Puoi anche utilizzare l'alias my_customer per rappresentare il customerId del tuo account. customerId viene restituito anche all'interno della risorsa Utenti. Devi fornire il parametro customer o domain.

Parametri di query

Parametri
maxResults

integer

Il numero massimo di risultati da restituire.
pageToken

string

Token per specificare la pagina successiva nell'elenco.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

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

Rappresentazione JSON 
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (Role)
    }
  ],
  "nextPageToken": string
}
Campi
kind

string

Il tipo di risorsa API. Questo valore è sempre admin#directory#roles.
etag

string

ETag della risorsa.
items[]

object (Role)

Un elenco di risorse Role.
nextPageToken

string

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/admin.directory.rolemanagement
  • https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.