REST Resource: orgunits

Recurso: unidade organizacional

Ao gerenciar as unidades organizacionais da sua conta, você pode configurar as configurações acesso 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 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. Este campo está obsoleto. Não há mais suporte para a definição dele como true, e isso pode ter consequências não intencionais. Para mais informações sobre heranças e usuários em uma estrutura organizacional, 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 "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 ele 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 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.