REST Resource: orgunits

Recurso: OrgUnit

Com o gerenciamento das unidades organizacionais da sua conta, você pode definir configurações personalizadas e o acesso dos usuários a serviços. Para mais informações sobre as 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

Determina se uma subunidade 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. A utilização desse campo está suspensa. A definição como true não é mais compatível e pode ter consequências indesejadas. Para mais informações sobre herança e usuários em uma estrutura organizacional, consulte a Central de Ajuda para administração.
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 do name da unidade organizacional. Por exemplo, para uma unidade organizacional chamada "apps" na organização pai "/engineering", o 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 vai mudar. Para mais informações sobre estruturas organizacionais, consulte a Central de Ajuda para administração. 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 para a 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.