Method: roleAssignments.list

Ruft eine paginierte 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 des Google Workspace-Kontos des Kunden. Bei einem Konto mit mehreren Domains können Sie dieses Feld anstelle von domain verwenden, um alle Gruppen für einen Kunden abzurufen. Sie können auch den my_customer-Alias verwenden, um die customerId Ihres Kontos darzustellen. Das 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.
roleId

string

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

string

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

boolean

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

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 RoleAssignment-Ressourcen.
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.