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 la cuenta, también puedes usar el alias my_customer para representar el customerId de tu cuenta. El customerId también se muestra 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 las unidades organizativas secundarias 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 unidad organizativa, el tipo es admin#directory#orgUnits.
etag

string

ETag del recurso.
organizationUnits[]

object (OrgUnit)

Una lista de objetos de unidad organizativa.

Permisos 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 unidades organizativas secundarias
CHILDREN Solo elementos secundarios inmediatos (predeterminado)
ALL_INCLUDING_PARENT Todas las unidades organizativas secundarias y la unidad organizativa especificada (raíz si no se especifica).