Method: orgunits.list

Ruft eine Liste aller Organisationseinheiten für ein Konto ab.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Die eindeutige ID für das Google Workspace-Konto des Kunden. Als Kontoadministrator können Sie auch den Alias my_customer verwenden, um die customerId Ihres Kontos zu repräsentieren. Die customerId wird auch als Teil der Ressource „Nutzer“ zurückgegeben.

Abfrageparameter

Parameter
orgUnitPath

string

Der vollständige Pfad zur Organisationseinheit oder ihre eindeutige ID. Gibt die untergeordneten Elemente der angegebenen Organisationseinheit zurück.
type

enum (Type)

Gibt an, ob alle untergeordneten Organisationen oder nur unmittelbare untergeordnete Organisationen zurückgegeben werden sollen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung 
{
  "kind": string,
  "etag": string,
  "organizationUnits": [
    {
      object (OrgUnit)
    }
  ]
}
Felder
kind

string

Der Typ der API-Ressource. Für Ressourcen der Organisationseinheit ist der Typ admin#directory#orgUnits.
etag

string

ETag der Ressource.
organizationUnits[]

object (OrgUnit)

Eine Liste von Organisationseinheitsobjekten.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • 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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.

Typ

Enums
ALL Alle untergeordneten Organisationseinheiten.
CHILDREN Nur unmittelbare untergeordnete Elemente (Standard).
ALL_INCLUDING_PARENT Alle untergeordneten Organisationseinheiten und die angegebene Organisationseinheit (Stammorganisationseinheit, falls nicht angegeben).