REST Resource: orgunits

Ressource: OrgUnit

Wenn Sie die Organisationseinheiten Ihres Kontos verwalten, können Sie den Zugriff Ihrer Nutzer auf Dienste und benutzerdefinierte Einstellungen konfigurieren. Weitere Informationen zu gängigen Aufgaben für Organisationseinheiten finden Sie im Entwicklerleitfaden. Die Hierarchie der Organisationseinheit des Kunden ist auf 35 Ebenen beschränkt.

JSON-Darstellung 
{
  "kind": string,
  "name": string,
  "description": string,
  "etag": string,
  "blockInheritance": boolean,
  "orgUnitId": string,
  "orgUnitPath": string,
  "parentOrgUnitId": string,
  "parentOrgUnitPath": string
}
Felder
kind

string

Der Typ der API-Ressource. Bei Ressourcen für Organisationseinheiten ist der Wert admin#directory#orgUnit.
name

string

Der Pfadname der Organisationseinheit. Der Name einer Organisationseinheit im übergeordneten Pfad „/corp/support/sales_support“ lautet beispielsweise „sales_support“. Erforderlich.
description

string

Beschreibung der Organisationseinheit.
etag

string

ETag der Ressource.
blockInheritance
(deprecated)

boolean

Dieses Feld wird nicht mehr unterstützt. Das Festlegen eines Werts hat keine Auswirkungen.
orgUnitId

string

Die eindeutige ID der Organisationseinheit.
orgUnitPath

string

Der vollständige Pfad zur Organisationseinheit. orgUnitPath ist eine abgeleitete Property. Wenn es aufgeführt ist, wird es aus parentOrgunitPath und name der Organisationseinheit abgeleitet. Für eine Organisationseinheit mit dem Namen „apps“ unter der übergeordneten Organisation „/engineering“ lautet der „orgUnitPath“ beispielsweise „/engineering/apps“. Wenn Sie eine orgUnitPath bearbeiten möchten, aktualisieren Sie entweder den Namen der Organisation oder die parentOrgunitPath.
Die Organisationseinheit eines Nutzers bestimmt, auf welche Google Workspace-Dienste der Nutzer Zugriff hat. Wenn der Nutzer zu einer neuen Organisation verschoben wird, ändert sich sein Zugriff. Weitere Informationen zu Organisationsstrukturen finden Sie in der Verwaltungshilfe. Weitere Informationen zum Verschieben eines Nutzers in eine andere Organisation finden Sie unter orgunits.update a user.
parentOrgUnitId

string

Die eindeutige ID der übergeordneten Organisationseinheit. Erforderlich, es sei denn, parentOrgUnitPath ist festgelegt.
parentOrgUnitPath

string

Der übergeordnete Pfad der Organisationseinheit. Beispiel: /corp/sales ist der übergeordnete Pfad für die Organisationseinheit /corp/sales/sales_support. Erforderlich, es sei denn, parentOrgUnitId ist festgelegt.

Methoden

delete

 Entfernt eine Organisationseinheit.

get

 Ruft eine Organisationseinheit ab.

insert

 Hiermit wird eine Organisationseinheit hinzugefügt.

list

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

patch

 Aktualisiert eine Organisationseinheit.

update

 Aktualisiert eine Organisationseinheit.