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. למשאבים של Orgunits, הערך הוא admin#directory#orgUnit.
name

string

שם הנתיב של היחידה הארגונית. לדוגמה, שם היחידה הארגונית בנתיב ההורה /corp/support/sales_support הוא sales_support. חובה.
description

string

תיאור היחידה הארגונית.
etag

string

ה-ETag של המשאב.
blockInheritance
(deprecated)

boolean

קובע אם יחידה ארגונית משנית יכולה לרשת את ההגדרות של הארגון ההורה. ערך ברירת המחדל הוא false, כלומר יחידה ארגונית משנית יורשת את ההגדרות של היחידה הארגונית הקרובה ביותר ברמה עליונה. השדה הזה הוצא משימוש. אי אפשר יותר להגדיר אותו כ-true, ויכולות להיות לכך השלכות בלתי רצויות. מידע נוסף על ירושה ועל משתמשים במבנה הארגוני זמין במרכז העזרה לניהול.
orgUnitId

string

המזהה הייחודי של היחידה הארגונית.
orgUnitPath

string

הנתיב המלא ליחידה הארגונית. הנכס orgUnitPath הוא נכס נגזר. כשהוא מופיע ברשימה, הוא נגזר מ-parentOrgunitPath ומ-name של היחידה הארגונית. לדוגמה, עבור יחידה ארגונית בשם 'apps' שנמצאת בארגון ההורה '‎/engineering', הערך של orgUnitPath הוא '‎/engineering/apps'. כדי לערוך orgUnitPath, צריך לעדכן את שם הארגון או את parentOrgunitPath.
היחידה הארגונית של המשתמש קובעת לאילו שירותי Google Workspace תהיה לו גישה. אם המשתמש מועבר לארגון חדש, הגישה שלו משתנה. מידע נוסף על מבני ארגון זמין במרכז העזרה לניהול. מידע נוסף על העברת משתמש לארגון אחר זמין במאמר orgunits.update a user.
parentOrgUnitId

string

המזהה הייחודי של היחידה הארגונית ברמה העליונה. חובה, אלא אם מוגדר parentOrgUnitPath.
parentOrgUnitPath

string

הנתיב של היחידה הארגונית ברמה העליונה. לדוגמה, ‎/corp/sales הוא הנתיב ההורה של היחידה הארגונית ‎ /corp/sales/sales_support. חובה, אלא אם מוגדר parentOrgUnitId.

שיטות

delete

 הסרת יחידה ארגונית.

get

 אחזור של יחידה ארגונית.

insert

 הוספת יחידה ארגונית.

list

 אחזור רשימה של כל היחידות הארגוניות בחשבון.

patch

 עדכון של יחידה ארגונית.

update

 עדכון של יחידה ארגונית.