Method: roleAssignments.list

Pobiera ponumerowany wykaz wszystkich przypisań ról.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customer

string

Unikalny identyfikator konta Google Workspace klienta. W przypadku konta obejmującego wiele domen, aby pobrać wszystkie grupy klienta, użyj tego pola zamiast pola domain. Możesz też użyć aliasu my_customer, aby reprezentować customerId na swoim koncie. Wartość customerId jest też zwracana jako część zasobu Users. Musisz podać parametr customer lub domain.

Parametry zapytania

Parametry
maxResults

integer

Maksymalna liczba wyników do zwrócenia.

pageToken

string

Token do określenia następnej strony na liście.

roleId

string

Niezmienny identyfikator roli. Jeśli jest uwzględniony w żądaniu, zwraca tylko przypisania ról zawierające ten identyfikator roli.

userKey

string

Podstawowy adres e-mail, alias adresu e-mail lub unikalny identyfikator użytkownika lub grupy. Jeśli jest uwzględniony w prośbie, zwraca przypisania ról tylko dla tego użytkownika lub tej grupy.

includeIndirectRoleAssignments

boolean

Gdy jest ustawione na true, pobiera przypisania ról pośrednich (np. przypisanie roli za pomocą grupy) oraz bezpośrednich. Domyślna wartość to false. Musisz podać wartość userKey, w przeciwnym razie przypisania ról pośrednich nie zostaną uwzględnione.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (RoleAssignment)
    }
  ],
  "nextPageToken": string
}
Pola
kind

string

Typ zasobu interfejsu API. Jest ona zawsze admin#directory#roleAssignments.

etag

string

ETag zasobu.

items[]

object (RoleAssignment)

Lista zasobów RoleAssignment.

nextPageToken

string

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.