REST Resource: orgunits

Recurso: OrgUnit

Administrar las unidades organizativas de tu cuenta te permite configurar el acceso de los usuarios a los servicios y los parámetros de configuración personalizados. Para obtener más información sobre las tareas comunes de las unidades organizativas, consulta la Guía para desarrolladores. La jerarquía de la unidad organizativa del cliente está limitada a 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 unidades organizativas, el valor es admin#directory#orgUnit.

name

string

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

description

string

Es la descripción de la unidad organizativa.

etag

string

ETag del recurso.

blockInheritance

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. Te recomendamos usar el valor predeterminado porque configurar blockInheritance en true puede tener consecuencias no deseadas. Para obtener más información sobre la herencia y los usuarios en una estructura organizativa, consulta el Centro de ayuda de administración.

orgUnitId

string

El ID único de la unidad organizativa.

orgUnitPath

string

Es la ruta completa a la unidad organizativa. orgUnitPath es una propiedad derivada. Cuando aparece en la lista, deriva de parentOrgunitPath y del name de la unidad organizativa. Por ejemplo, en el caso de una unidad organizativa llamada “apps” de la organización superior “/engineering”, la unidad organizativa es “/engineering/apps”. Para editar una orgUnitPath, actualiza el nombre de la organización o la parentOrgunitPath.
La unidad organizativa de un usuario determina a qué servicios de Google Workspace tiene acceso. Si el usuario se traslada a una organización nueva, su acceso cambiará. Para obtener más información sobre las estructuras organizativas, consulta el Centro de ayuda de la administración. Si quieres obtener más información para mover 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 establezca parentOrgUnitPath.

parentOrgUnitPath

string

Ruta superior de la unidad organizativa. Por ejemplo, /corp/ventas es la ruta superior para la unidad organizativa /corp/sales/sales_support. Obligatorio, a menos que se establezca 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.