REST Resource: orgunits

Recurso: unidade organizacional

Ao gerenciar as unidades organizacionais da sua conta, você pode configurar o acesso dos usuários a serviços e configurações personalizadas. Para mais informações sobre tarefas comuns de unidades organizacionais, consulte o Guia para desenvolvedores. 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 /corp/support/sales_support é sales_support. Obrigatório.

description

string

Descrição da unidade organizacional.

etag

string

ETag do recurso.

blockInheritance
(deprecated)

boolean

Esse campo foi descontinuado e definir o valor dele não tem efeito.

orgUnitId

string

O ID exclusivo da unidade organizacional.

orgUnitPath

string

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

parentOrgUnitId

string

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/sales é o caminho pai da unidade organizacional /corp/sales/sales_support. 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.