Method: roleAssignments.list

Ruft eine paginaierte Liste aller Rollenzuweisungen ab.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customer

string

Die eindeutige ID für das Google Workspace-Konto des Kunden. Wenn Sie bei einem mehrdomänenfähigen Konto alle Gruppen für einen Kunden abrufen möchten, verwenden Sie dieses Feld anstelle von domain. Sie können auch den Alias my_customer verwenden, um die customerId Ihres Kontos zu repräsentieren. Die customerId wird auch als Teil der Ressource Nutzer zurückgegeben. Sie müssen entweder den Parameter customer oder den Parameter domain angeben.

Abfrageparameter

Parameter
maxResults

integer

Maximale Anzahl der zurückzugebenden Ergebnisse.
pageToken

string

Token, mit dem die nächste Seite in der Liste angegeben wird.
roleId

string

Unveränderliche ID einer Rolle. Wenn diese ID in der Anfrage enthalten ist, werden nur Rollenzuweisungen zurückgegeben, die diese Rollen-ID enthalten.
userKey

string

Die primäre E-Mail-Adresse, Alias-E-Mail-Adresse oder eindeutige Nutzer- oder Gruppen-ID. Wenn dieser Parameter in der Anfrage enthalten ist, werden nur Rollenzuweisungen für diesen Nutzer oder diese Gruppe zurückgegeben.
includeIndirectRoleAssignments

boolean

Wenn diese Option auf true festgelegt ist, werden sowohl indirekte Rollenzuweisungen (d.h. Rollenzuweisungen über eine Gruppe) als auch direkte Rollenzuweisungen abgerufen. Die Standardeinstellung ist false. Sie müssen userKey angeben, da andernfalls die indirekten Rollenzuweisungen nicht berücksichtigt werden.

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

string

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

string

ETag der Ressource.
items[]

object (RoleAssignment)

Eine Liste von Ressourcen vom Typ „RoleAssignment“.
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.