REST Resource: orgunits

资源:组织部门

通过管理您账号的组织部门,您可以配置用户的访问服务和自定义设置。如需详细了解常见的组织部门任务,请参阅开发者指南。客户的组织部门层次结构最多只能有 35 个层级。

JSON 表示法
{
  "kind": string,
  "name": string,
  "description": string,
  "etag": string,
  "blockInheritance": boolean,
  "orgUnitId": string,
  "orgUnitPath": string,
  "parentOrgUnitId": string,
  "parentOrgUnitPath": string
}
字段
kind

string

API 资源的类型。对于组织部门资源,值为 admin#directory#orgUnit

name

string

组织部门的路径名称。例如,/corp/support/sales_support 父级路径中组织部门的名称为 sales_support。必填。

description

string

组织部门的说明。

etag

string

资源的 ETag。

blockInheritance
(deprecated)

boolean

确定下级组织部门是否可以继承上级组织的设置。默认值为 false,表示下级组织部门会继承距离最近的上级组织部门的设置。此字段已弃用。系统已不再支持将其设置为 true,这可能会带来意想不到的后果。要详细了解组织结构中的沿用和用户,请参阅管理帮助中心

orgUnitId

string

组织部门的唯一 ID。

orgUnitPath

string

组织部门的完整路径。orgUnitPath 是一个派生属性。列出后,它来源于 parentOrgunitPath 和组织部门的 name。举例来说,对于名为“apps”的组织部门在上级组织“/engineering”下,orgUnitPath 为“/engineering/apps”。如需修改 orgUnitPath,请更新组织名称或 parentOrgunitPath
用户所属的 Google Workspace 服务由用户所属的组织部门决定。如果用户被移至新的组织,其访问权限会发生变化。如需详细了解组织结构,请参阅管理帮助中心。要详细了解如何将用户移至其他单位,请参阅 orgunits.update 用户

parentOrgUnitId

string

上级组织部门的唯一 ID。必需,除非设置了 parentOrgUnitPath

parentOrgUnitPath

string

组织部门的父级路径。例如,“/corp/sales”是“/corp/sales/sales_support”组织部门的父级路径。必需,除非设置了 parentOrgUnitId

方法

delete

移除组织部门。

get

检索组织部门。

insert

添加组织部门。

list

检索账号的所有组织部门的列表。

patch

更新组织部门。

update

更新组织部门。