REST Resource: orgunits

Recurso: OrgUnit

Ao gerenciar as unidades organizacionais da sua conta, você pode configurar o acesso dos usuários aos serviços e configurações personalizadas. Veja mais informações sobre tarefas comuns de unidades organizacionais no Guia do desenvolvedor. A hierarquia da unidade organizacional do cliente é limitada a 35 níveis de profundidade.

Representação JSON
{
  "kind": string,
  "name": string,
  "description": string,
  "etag": string,
  "blockInheritance": boolean,
  "orgUnitId": string,
  "orgUnitPath": string,
  "parentOrgUnitId": string,
  "parentOrgUnitPath": string
}
Campos
kind

string

O tipo do recurso da API. Para recursos de unidades organizacionais, o valor é admin#directory#orgUnit.

name

string

O nome do caminho da unidade organizacional. Por exemplo, o nome de uma unidade organizacional no caminho pai de /corp/support/sales_support é sales_support. Obrigatório.

description

string

Descrição da unidade organizacional.

etag

string

ETag do recurso.

blockInheritance

boolean

Determina se uma unidade organizacional pode herdar as configurações da organização mãe. O valor padrão é false, o que significa que uma subunidade organizacional herda as configurações da unidade organizacional mãe mais próxima. Para mais informações sobre herança e usuários em uma estrutura organizacional, consulte a Central de Ajuda de administração.

orgUnitId

string

Mostra o ID exclusivo da unidade organizacional.

orgUnitPath

string

Caminho completo para a unidade organizacional. O orgUnitPath é uma propriedade derivada. Quando listado, ele é derivado de parentOrgunitPath e da unidade organizacional name. Por exemplo, para uma unidade organizacional chamada 'apps' na organização mãe '/engineering', orgUnitPath é '/engineering/apps'. Para editar um orgUnitPath, atualize o nome da organização ou o parentOrgunitPath.
A unidade organizacional de um usuário determina a quais serviços do Google Workspace o usuário tem acesso. Se o usuário for movido para uma nova organização, o acesso dele será alterado. Para mais informações sobre estruturas organizacionais, consulte a Central de Ajuda de administração. Para mais informações sobre como mover um usuário para uma organização diferente, consulte chromeosdevices.update a user.

parentOrgUnitId

string

Mostra o ID exclusivo da unidade organizacional mãe. Obrigatório, a menos que parentOrgUnitPath esteja definido.

parentOrgUnitPath

string

O caminho pai da unidade organizacional. Por exemplo, /corp/vendas é o caminho pai da unidade organizacional /corp/vendas/vendas_suporte. Obrigatório, a menos que parentOrgUnitId esteja definido.

Métodos

delete

Remove uma unidade organizacional.

get

Recupera uma unidade organizacional.

insert

Adiciona uma unidade organizacional.

list

Recupera uma lista de todas as unidades organizacionais de uma conta.

patch

Atualiza uma unidade organizacional.

update

Atualiza uma unidade organizacional.