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. Si deseas 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 la ruta de acceso 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
(deprecated)

boolean

Determina si una unidad organizativa 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 configurarlo en true y 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

La ruta completa hacia la unidad organizativa. orgUnitPath es una propiedad derivada. Cuando aparece, deriva de parentOrgunitPath y name de la unidad organizativa. Por ejemplo, para una unidad organizativa llamada “apps” perteneciente a la organización superior “/ingeniería” (/engineering), la orgUnitPath es “/ingeniería/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á. Si quieres obtener más información sobre las estructuras organizativas, consulta el Centro de ayuda para administradores. Si quieres obtener más información para mover un usuario a otra organización, consulta orgunits.update un usuario.

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 principal para la unidad organizativa /corp/ventas/ventas_asistencia. 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.