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

boolean

确定下级组织部门是否可以继承上级组织的设置。默认值为 false,表示下级组织部门会继承最近的上级组织部门的设置。我们建议使用默认值,因为将 blockInheritance 设置为 true 可能会产生意外后果。要详细了解组织结构中的沿用情况和用户,请参阅管理帮助中心

orgUnitId

string

组织部门的唯一 ID。

orgUnitPath

string

组织部门的完整路径。orgUnitPath 是一个派生属性。列出时,它源自于“parentOrgunitPath”和组织部门的“name”。例如,对于上级组织“/engineering”下名为“apps”的组织部门,组织部门路径为“/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

更新组织部门。