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 資源的類型。對於 Orgunits 資源，這個值為 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」。舉例來說，如果機構單位路徑名為「/engineering」，則 orgUnitPath 為「/engineering/apps」。如要編輯 orgUnitPath，請更新機構名稱或 parentOrgunitPath。
使用者可使用的 Google Workspace 服務將由其所屬的機構單位決定。如果使用者移至新機構，使用者的存取權就會變更。如要進一步瞭解機構結構，請參閱管理說明中心。如要進一步瞭解如何將使用者移至其他機構，請參閱「orgunits.update a user」。
parentOrgUnitId

string

上層機構單位的專屬 ID。如未設定 parentOrgUnitPath，則為必要欄位。
parentOrgUnitPath

string

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

方法

delete

 移除機構單位。

get

 擷取機構單位。

insert

 新增機構單位。

list

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

patch

 更新機構單位。

update

 更新機構單位。