Method: orgunits.list

Pobiera listę wszystkich jednostek organizacyjnych konta.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Unikalny identyfikator konta Google Workspace klienta. Jako administrator konta możesz też używać aliasu my_customer do reprezentowania grupy customerId swojego konta. Wartość customerId jest też zwracana w ramach zasobu Użytkownicy.

Parametry zapytania

Parametry
orgUnitPath

string

Pełna ścieżka jednostki organizacyjnej lub jej unikalny identyfikator. Zwraca elementy podrzędne określonej jednostki organizacyjnej.
type

enum (Type)

Określa, czy należy zwrócić wszystkie organizacje podrzędne, czy tylko natychmiastowe jednostki podrzędne.

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,
  "organizationUnits": [
    {
      object (OrgUnit)
    }
  ]
}
Pola
kind

string

Typ zasobu interfejsu API. W przypadku zasobów jednostki organizacyjnej typ to admin#directory#orgUnits.
etag

string

ETag zasobu.
organizationUnits[]

object (OrgUnit)

Lista obiektów jednostek organizacyjnych.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://apps-apis.google.com/a/feeds/policies/
  • https://www.googleapis.com/auth/admin.directory.orgunit
  • https://www.googleapis.com/auth/admin.directory.orgunit.readonly

Więcej informacji znajdziesz w przewodniku po autoryzacji.

Typ

Wartości w polu enum
ALL Wszystkie podrzędne jednostki organizacyjne.
CHILDREN Tylko natychmiastowe elementy podrzędne (domyślnie).
ALL_INCLUDING_PARENT Wszystkie podrzędne jednostki organizacyjne i określona jednostka organizacyjna (katalog główny, jeśli nie został określony).