Method: orgunits.list

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

string

El ID único de la cuenta de Google Workspace del cliente. Como administrador de cuentas, también puedes usar el alias my_customer para representar el customerId de tu cuenta. También se muestra customerId como parte del recurso Usuarios.

Parámetros de consulta

Parámetros
orgUnitPath

string

Es la ruta de acceso completa a la unidad organizativa o su ID único. Muestra los elementos secundarios de la unidad organizativa especificada.
type

enum (Type)

Indica si se deben mostrar todas las suborganizaciones o solo las secundarias inmediatas.

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 (OrgUnit)
    }
  ]
}
Campos
kind

string

Tipo de recurso de la API. Para los recursos de unidades organizativas, el tipo es admin#directory#orgUnits.
etag

string

ETag del recurso.
organizationUnits[]

object (OrgUnit)

Es una lista de objetos de unidades organizativas.

Permisos de autorización

Se necesita uno de los siguientes alcances 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

Enumeradores
ALL Todas las subunidades organizativas.
CHILDREN Solo elementos secundarios inmediatos (predeterminado).
ALL_INCLUDING_PARENT Todas las subunidades organizativas y la unidad organizativa especificada (raíz si no se especifica)