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
(deprecated)

boolean

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

string

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

string

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

string

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

string

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

שיטות

delete

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

get

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

insert

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

list

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

patch

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

update

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