Method: orgunits.list

Pobiera listę wszystkich jednostek organizacyjnych na koncie.

Żą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 domeny customerId na Twoim koncie. Zasób customerId jest też zwracany w ramach zasobu Użytkownicy.

Parametry zapytania

Parametry
orgUnitPath

string

Pełna ścieżka do jednostki organizacyjnej lub jej unikalnego identyfikatora. Zwraca elementy podrzędne określonej jednostki organizacyjnej.

type

enum (Type)

Określa, czy zwracane są wszystkie organizacje podrzędne, czy tylko najbliższe organizacje 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

Tag ETag zasobu.

organizationUnits[]

object (OrgUnit)

Lista obiektów jednostek organizacyjnych.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu 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 na temat autoryzacji.

Typ

Wartości w polu enum
ALL Wszystkie podrzędne jednostki organizacyjne.
CHILDREN Tylko dla dzieci (domyślnie).
ALL_INCLUDING_PARENT Wszystkie podrzędne jednostki organizacyjne i wskazana jednostka organizacyjna (jeśli nie określono jednostki organizacyjnej najwyższego poziomu).