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 de unidades organizacionais do cliente é limitada a 35 níveis de detalhamento.

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 unidade organizacional secundária 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. Este campo está obsoleto. A configuração 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 de organização, consulte a Central de Ajuda de 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 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.