Method: roleAssignments.list

Pobiera podzieloną na strony listę wszystkich roleAssignments.

Żą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 z wieloma domenami, aby pobrać wszystkie grupy klienta, użyj tego pola zamiast domain. Możesz też użyć aliasu my_customer do reprezentowania identyfikatora customerId swojego konta. Element customerId jest też zwracany 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 określający następną stronę na liście.

roleId

string

Stały identyfikator roli. Jeśli żądanie znajduje się 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 albo grupy. Jeśli żądanie zostało uwzględnione w żądaniu, zwraca przypisane role tylko dla tego użytkownika lub tej grupy.

includeIndirectRoleAssignments

boolean

Gdy ma wartość true, pobiera zarówno przypisania ról pośrednich (np. przypisania ról za pomocą grupy), jak i bezpośrednich. Domyślna wartość to false. Musisz określić 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 to 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 po autoryzacji.