REST Resource: orgunits

Ressource: Organisationseinheit

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 Entwicklerhandbuch. Die Hierarchie der Organisationseinheiten des Kunden ist auf 35 Tiefenebenen 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. Für Ressourcen der Organisationseinheit lautet 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

Bestimmt, ob eine untergeordnete Organisationseinheit die Einstellungen der übergeordneten Organisation übernehmen kann. Der Standardwert ist false. Das bedeutet, dass eine untergeordnete Organisationseinheit die Einstellungen der übergeordneten Organisationseinheit übernimmt. Die Verwendung dieses Feldes wurde eingestellt. Die Einstellung auf true wird nicht mehr unterstützt und kann unbeabsichtigte Folgen haben. Weitere Informationen zu Überschreibungen und Nutzern in einer Organisationsstruktur finden Sie in der Verwaltungshilfe.
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.