REST Resource: orgunits

Ressource: OrgUnit

Gérer les unités organisationnelles de votre compte vous permet de configurer l'accès de vos utilisateurs aux services et aux paramètres personnalisés. Pour en savoir plus sur les tâches courantes liées aux unités organisationnelles, consultez le guide du développeur. La hiérarchie des unités organisationnelles du client est limitée à 35 niveaux de profondeur.

Représentation JSON
{
  "kind": string,
  "name": string,
  "description": string,
  "etag": string,
  "blockInheritance": boolean,
  "orgUnitId": string,
  "orgUnitPath": string,
  "parentOrgUnitId": string,
  "parentOrgUnitPath": string
}
Champs
kind

string

Type de ressource d'API. Pour les ressources Orgunits, la valeur est admin#directory#orgUnit.

name

string

Nom de chemin d'accès de l'unité organisationnelle. Par exemple, le nom d'une unité organisationnelle dans le chemin d'accès parent /corp/support/sales_support est sales_support. Obligatoire.

description

string

Description de l'unité organisationnelle.

etag

string

ETag de la ressource.

blockInheritance
(deprecated)

boolean

Détermine si une sous-unité organisationnelle peut hériter des paramètres de l'organisation parente. La valeur par défaut est false, ce qui signifie qu'une sous-unité organisationnelle hérite des paramètres de l'unité organisationnelle parente la plus proche. Ce champ a été abandonné. Il n'est plus possible de le définir sur true, car cela peut avoir des conséquences inattendues. Pour en savoir plus sur l'héritage et les utilisateurs dans une structure organisationnelle, consultez le Centre d'aide pour les administrateurs.

orgUnitId

string

ID unique de l'unité organisationnelle.

orgUnitPath

string

Chemin d'accès complet vers l'unité organisationnelle. orgUnitPath est une propriété dérivée. Lorsqu'il est répertorié, il est dérivé de parentOrgunitPath et de l'élément name de l'unité organisationnelle. Par exemple, pour une unité organisationnelle nommée "apps" sous l'organisation parente "/engineering", orgUnitPath est "/engineering/apps". Pour modifier un orgUnitPath, modifiez le nom de l'organisation ou le parentOrgunitPath.
L'unité organisationnelle d'un utilisateur détermine les services Google Workspace auxquels il a accès. Si l'utilisateur est transféré vers une nouvelle organisation, ses droits d'accès changent. Pour en savoir plus sur les structures organisationnelles, consultez le Centre d'aide pour les administrateurs. Pour en savoir plus sur le transfert d'un utilisateur vers une autre organisation, consultez orgunits.update a user (orgunits.update un utilisateur).

parentOrgUnitId

string

Identifiant unique de l'unité organisationnelle parente. Obligatoire, sauf si parentOrgUnitPath est défini.

parentOrgUnitPath

string

Chemin d'accès parent de l'unité organisationnelle. Par exemple, /corp/sales est le chemin parent de l'unité organisationnelle /corp/sales/sales_support. Obligatoire, sauf si parentOrgUnitId est défini.

Méthodes

delete

Supprime une unité organisationnelle.

get

Récupère une unité organisationnelle.

insert

Ajoute une unité organisationnelle.

list

Récupère la liste de toutes les unités organisationnelles d'un compte.

patch

Met à jour une unité organisationnelle.

update

Met à jour une unité organisationnelle.