REST Resource: orgunits

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

資源:OrgUnit

管理帳戶的機構單位可讓您為使用者設定服務存取權和自訂設定。如要進一步瞭解常見的機構單位工作,請參閱開發人員指南。客戶的機構單位階層數量上限為 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,表示子機構單位會沿用最接近的上層機構單位設定。如要進一步瞭解機構架構中的繼承和使用者,請參閱管理員說明中心

orgUnitId

string

機構單位的專屬 ID。

orgUnitPath

string

機構單位的完整路徑。orgUnitPath 是衍生屬性。列出後,即會產生來自 parentOrgunitPath 和機構單位的 name。舉例來說,如果是名為「#39;apps'」的機構單位,在上層機構「#39;/machineing'」下方,orgUnitPath 就是「#39;/machineing/apps'」。如要編輯 orgUnitPath,請更新機構名稱或 parentOrgunitPath
使用者的機構單位會決定他們有權存取哪些 Google Workspace 服務,如果使用者移至新的機構,使用者的存取權就會改變。如要進一步瞭解機構架構,請參閱管理員說明中心。如要進一步瞭解如何將使用者移至其他機構,請參閱 chromeosdevices.update 使用者

parentOrgUnitId

string

上層機構單位的專屬 ID。除非已設定 parentOrgUnitPath,否則此為必要項目。

parentOrgUnitPath

string

機構單位的上層路徑。舉例來說,/corp/sales 是 /corp/sales/sales_support 機構單位的父項路徑。除非已設定 parentOrgUnitId,否則此為必要項目。

方法

delete

移除機構單位。

get

擷取機構單位。

insert

新增機構單位。

list

擷取帳戶所有機構單位的清單。

patch

更新機構單位。

update

更新機構單位。