REST Resource: orgunits

Ressource: Organisationseinheit

Durch das Verwalten der Organisationseinheiten Ihres Kontos können Sie die Zugriff auf Dienste und benutzerdefinierte Einstellungen. 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

Das ETag der Ressource.
blockInheritance
(deprecated)

boolean

Legt fest, ob eine untergeordnete Organisationseinheit die Einstellungen der übergeordneten Organisation übernehmen kann. Der Standardwert ist false. Das bedeutet, dass eine untergeordnete Organisationseinheit die Einstellungen der nächstgelegenen übergeordneten Organisationseinheit übernimmt. Die Verwendung dieses Feldes wurde eingestellt. Das Festlegen auf true wird nicht mehr unterstützt und kann unbeabsichtigte Folgen haben. Weitere Informationen zur Übernahme und zu Nutzern in einer Organisationsstruktur finden Sie in der Hilfe für Administratoren.
orgUnitId

string

Die eindeutige ID der Organisationseinheit.
orgUnitPath

string

Der vollständige Pfad zur Organisationseinheit. orgUnitPath ist eine abgeleitete Property. In der Liste werden sie aus parentOrgunitPath und den name der Organisationseinheit abgeleitet. Beispiel: Für eine Organisationseinheit namens „Apps“ unter der übergeordneten Organisation „/engineering“ ist der orgUnitPath „/engineering/apps“. Wenn Sie ein orgUnitPath bearbeiten möchten, aktualisieren Sie entweder den Namen der Organisation oder die parentOrgunitPath.
Von der Organisationseinheit eines Nutzers hängt ab, auf welche Google Workspace-Dienste der Nutzer Zugriff hat. Wenn der Nutzer in eine neue Organisation verschoben wird, ändert sich sein Zugriff. Weitere Informationen zu Organisationsstrukturen finden Sie in der Hilfe für Administratoren. 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, sofern parentOrgUnitPath nicht festgelegt ist.
parentOrgUnitPath

string

Der übergeordnete Pfad der Organisationseinheit. Beispiel: „/unternehmen/vertrieb“ ist der übergeordnete Pfad für die Organisationseinheit „/unternehmen/vertrieb/vertrieb_support“. Erforderlich, sofern parentOrgUnitId nicht festgelegt ist.

Methoden

delete

 Entfernt eine Organisationseinheit.

get

 Ruft eine Organisationseinheit ab.

insert

 Fügt eine Organisationseinheit hinzu.

list

 Ruft eine Liste aller Organisationseinheiten für ein Konto ab

patch

 Aktualisiert eine Organisationseinheit.

update

 Aktualisiert eine Organisationseinheit.