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 von 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

Pfadname der Organisationseinheit Beispiel: Der Name einer Organisationseinheit im übergeordneten Pfad /corp/support/sales_support lautet „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. Die Festlegung 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. Wenn es aufgeführt ist, wird es aus „parentOrgunitPath“ und der „name“ der Organisationseinheit abgeleitet. Für eine Organisationseinheit namens „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 den parentOrgunitPath.
Mit der Organisationseinheit eines Nutzers wird festgelegt, auf welche Google Workspace-Dienste der Nutzer zugreifen kann. Wenn der Nutzer in eine neue Organisation verschoben wird, ändert sich der Zugriff des Nutzers. 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 nicht parentOrgUnitPath festgelegt ist.

parentOrgUnitPath

string

Der übergeordnete Pfad der Organisationseinheit. Beispiel: „/corp/sales“ ist der übergeordnete Pfad für die Organisationseinheit „/corp/sales/sales_support“. Erforderlich, sofern nicht parentOrgUnitId festgelegt ist.

Methoden

delete

Organisationseinheit wird entfernt.

get

Ruft eine Organisationseinheit ab.

insert

Fügt eine Organisationseinheit hinzu.

list

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

patch

Hiermit wird eine Organisationseinheit aktualisiert.

update

Hiermit wird eine Organisationseinheit aktualisiert.