Method: roles.list

Pobiera ponumerowane listy wszystkich ról w domenie.

Żądanie HTTP

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

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.

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

string

Typ zasobu interfejsu API. Jest ona zawsze admin#directory#roles.
etag

string

ETag zasobu.
items[]

object (Role)

Lista zasobów roli.
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.