Recupera una lista de todas las unidades organizativas de una cuenta.
Solicitud HTTP
GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/orgunits
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
customerId |
El ID único de la cuenta de Google Workspace del cliente. Como administrador de la cuenta, también puedes usar el alias |
Parámetros de consulta
Parámetros | |
---|---|
orgUnitPath |
La ruta de acceso completa a la unidad organizativa o su ID único. Muestra los elementos secundarios de la unidad organizativa especificada. |
type |
Indica si se deben mostrar todas las suborganizaciones o solo los elementos secundarios inmediatos. |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si el proceso es satisfactorio, el cuerpo de la respuesta contiene datos con la siguiente estructura:
Representación JSON |
---|
{
"kind": string,
"etag": string,
"organizationUnits": [
{
object ( |
Campos | |
---|---|
kind |
Tipo de recurso de la API. Para los recursos de unidades organizativas, el tipo es |
etag |
ETag del recurso. |
organizationUnits[] |
Una lista de objetos de unidades organizativas. |
Alcances de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://apps-apis.google.com/a/feeds/policies/
https://www.googleapis.com/auth/admin.directory.orgunit
https://www.googleapis.com/auth/admin.directory.orgunit.readonly
Para obtener más información, consulta la Guía de autorización.
Tipo
Enumeraciones | |
---|---|
ALL |
Todas las subunidades organizativas. |
CHILDREN |
Solo elementos secundarios inmediatos (predeterminado). |
ALL_INCLUDING_PARENT |
Todas las subunidades organizativas y la unidad organizativa especificada (si no se especifica la raíz) |