REST Resource: orgunits

Recurso: OrgUnit

Administrar las unidades organizativas de tu cuenta te permite configurar el acceso de los usuarios a los servicios y la configuración personalizada. Para obtener más información sobre las tareas comunes de las unidades organizativas, consulta la Guía para desarrolladores. La jerarquía de las unidades organizativas del cliente tiene un límite de 35 niveles de profundidad.

Representación JSON 
{
  "kind": string,
  "name": string,
  "description": string,
  "etag": string,
  "blockInheritance": boolean,
  "orgUnitId": string,
  "orgUnitPath": string,
  "parentOrgUnitId": string,
  "parentOrgUnitPath": string
}
Campos
kind

string

Tipo de recurso de la API. Para los recursos de Orgunits, el valor es admin#directory#orgUnit.
name

string

Es el nombre de la ruta de acceso de la unidad organizativa. Por ejemplo, el nombre de una unidad organizativa dentro de la ruta de acceso superior /corp/support/sales_support es sales_support. Obligatorio.
description

string

Descripción de la unidad organizativa.
etag

string

ETag del recurso.
blockInheritance
(deprecated)

boolean

Determina si una unidad organizativa secundaria puede heredar la configuración de la organización superior. El valor predeterminado es false, lo que significa que una unidad organizativa secundaria hereda la configuración de la unidad organizativa superior más cercana. Este campo ya no está disponible. Ya no se admite establecerlo en true, y puede tener consecuencias no deseadas. Para obtener más información sobre la herencia y los usuarios en una estructura de organización, consulta el Centro de ayuda de administración.
orgUnitId

string

Es el ID único de la unidad organizativa.
orgUnitPath

string

Es la ruta de acceso completa a la unidad organizativa. orgUnitPath es una propiedad derivada. Cuando se muestra, se deriva de parentOrgunitPath y de la name de la unidad organizativa. Por ejemplo, para una unidad organizativa denominada "apps" de la organización superior "/engineering", la orgUnitPath es "/engineering/apps". Para editar un orgUnitPath, actualiza el nombre de la organización o el parentOrgunitPath.
La unidad organizativa de un usuario determina a qué servicios de Google Workspace tiene acceso el usuario. Si el usuario se traslada a una organización nueva, su acceso cambiará. Para obtener más información sobre las estructuras de organización, consulta el Centro de ayuda de administración. Para obtener más información sobre cómo trasladar un usuario a otra organización, consulta orgunits.update a user.
parentOrgUnitId

string

El ID único de la unidad organizativa superior. Obligatorio, a menos que se configure parentOrgUnitPath.
parentOrgUnitPath

string

Es la ruta de acceso superior de la unidad organizativa. Por ejemplo, /corp/ventas es la ruta superior de la unidad organizativa /corp/ventas/asistencia_ventas. Obligatorio, a menos que se configure parentOrgUnitId.

Métodos

delete

 Quita una unidad organizativa.

get

 Recupera una unidad organizativa.

insert

 Agrega una unidad organizativa.

list

 Recupera una lista de todas las unidades organizativas de una cuenta.

patch

 Actualiza una unidad organizativa.

update

 Actualiza una unidad organizativa.