Method: roleAssignments.list

Recupera un elenco impaginato di tutti i RoleAssignments.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customer

string

L'ID univoco dell'account Google Workspace del cliente. Nel caso di un account con più domini, per recuperare tutti i gruppi per un cliente utilizza questo campo anziché domain. Puoi anche utilizzare l'alias my_customer per rappresentare le customerId del tuo account. customerId viene restituito anche come parte della risorsa Users. Devi fornire il parametro customer o domain.

Parametri di ricerca

Parametri
maxResults

integer

Numero massimo di risultati da restituire.
pageToken

string

Token per specificare la pagina successiva nell'elenco.
roleId

string

ID immutabile di un ruolo. Se incluso nella richiesta, restituisce solo le assegnazioni di ruolo contenenti questo ID ruolo.
userKey

string

L'indirizzo email principale, l'indirizzo email dell'alias o l'ID utente unico o di gruppo. Se incluso nella richiesta, restituisce le assegnazioni dei ruoli solo per questo utente o gruppo.
includeIndirectRoleAssignments

boolean

Se impostato su true, recupera le assegnazioni di ruoli indirette (ovvero l'assegnazione dei ruoli tramite un gruppo) e quelle dirette. Il valore predefinito è false. Devi specificare userKey, altrimenti le assegnazioni dei ruoli indirette non verranno incluse.

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 (RoleAssignment)
    }
  ],
  "nextPageToken": string
}
Campi
kind

string

Il tipo di risorsa API. È sempre admin#directory#roleAssignments.
etag

string

ETag della risorsa.
items[]

object (RoleAssignment)

Un elenco di risorse RoleAssignment.
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 alle autorizzazioni.