Method: roles.list

Ruft eine paginierte Liste aller Rollen in einer Domain ab.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customer

string

Die eindeutige ID für das Google Workspace-Konto des Kunden. Verwenden Sie bei einem Konto mit mehreren Domains dieses Feld anstelle von domain, um alle Gruppen für einen Kunden abzurufen. Sie können auch den Alias my_customer verwenden, um die customerId Ihres Kontos darzustellen. customerId wird auch als Teil der Ressource Users zurückgegeben. Sie müssen den Parameter customer oder domain angeben.

Abfrageparameter

Parameter
maxResults

integer

Maximale Anzahl der zurückzugebenden Ergebnisse.

pageToken

string

Token zur Angabe der nächsten Seite in der Liste.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (Role)
    }
  ],
  "nextPageToken": string
}
Felder
kind

string

Der Typ der API-Ressource. Dies ist immer admin#directory#roles.

etag

string

Das ETag der Ressource.

items[]

object (Role)

Eine Liste von Rollenressourcen.

nextPageToken

string

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.