REST Resource: orgunits

Ressource: OrgUnit

Wenn Sie die Organisationseinheiten Ihres Kontos verwalten, können Sie den Zugriff auf Dienste und benutzerdefinierte Einstellungen konfigurieren. Weitere Informationen zu häufigen Aufgaben in einer Organisationseinheit finden Sie im Entwicklerleitfaden. Die Hierarchie der Organisationseinheiten 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. 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

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ächsten übergeordneten Organisationseinheit übernimmt. Weitere Informationen zur Übernahme und zu den Nutzern in einer Organisationsstruktur finden Sie in der Hilfe zur Verwaltung.

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 von parentOrgunitPath und der Organisationseinheit name abgeleitet. Beispiel: Für eine Organisationseinheit mit dem Namen 'apps' unter der übergeordneten Organisation '/engineering' lautet der orgUnitPath '/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 in eine neue Organisation verschoben wird, ändert sich der Zugriff des Nutzers. Weitere Informationen zu Organisationsstrukturen finden Sie in der Hilfe zur Verwaltung. Weitere Informationen zum Verschieben eines Nutzers in eine andere Organisation finden Sie unter chromeosdevices.update.

parentOrgUnitId

string

Die eindeutige ID der übergeordneten Organisationseinheit. Erforderlich, sofern parentOrgUnitPath nicht 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 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.