ה-Directory API הוא חלק מ-RESTful Admin SDK API, שאפשר להשתמש בו כדי ליצור ולנהל באופן פרוגרמטי משאבים בניהול אדמין שבבעלות חשבון Google Workspace. דוגמאות לתרחישים לדוגמה:
- יצירה וניהול של משתמשים והוספת מנהלי מערכת.
- יצירה וניהול של קבוצות וחברויות בקבוצות.
- מעקב אחר מכשירים שמחוברים לדומיין שלך וביצוע פעולות במכשירים שאבדו.
- ניהול התרשים הארגוני ומבני הארגון.
- אנחנו עורכים ביקורת לאפליקציות שהמשתמשים נתנו להן גישה אליהן, ומבטלים את הגישה שלהן לאפליקציות לא מורשות.
בהמשך מופיעה רשימה של המונחים הנפוצים ב-Directory API:
- לקוח/ה
- הישות שבבעלותה חשבון Google Workspace, שמיוצג על ידי המשאב לקוח.
- דומיין
- אם רלוונטי, דומיין ה-DNS שמשויך לחשבון Google Workspace, שמיוצג על ידי משאב הדומיין. לא לכל החשבונות משויך דומיין.
- יחידה ארגונית (OU)
- יחידת משנה של עץ הארגון בחשבון Google Workspace, המשמשת לקיבוץ ולמיון של משתמשים לצורך החלת מדיניות והענקת הרשאות. יחידה ארגונית מיוצגת על ידי המשאב OrgUnit.
- הרשאה
- היכולת של המשתמש לבצע פעולה במשאב של Google Workspace. מתייחסת בעיקר לאדמינים. כל הרשאה מיוצגת על ידי המשאב 'הרשאות'.
- תפקיד
- אוסף מוגדר של הרשאות שאפשר להקצות למשתמש או לקבוצת משתמשים, שמיוצג על ידי המשאב תפקיד.
- הקצאת תפקידים
- רשומה שמציינת איזה משתמש קיבל את התפקידים ומאיזה היקף. הקצאת תפקידים מיוצגת על ידי המשאב RoleAssignment.
- סכימה
- אובייקט JSON שמגדיר מאפייני משתמש מותאמים אישית לארגון, שמיוצגים על ידי המשאב סכימה.
- משתמש
- חשבון משתמש קצה נפרד עם גישה לאפליקציות ולמשאבים של Google Workspace, שמיוצג על ידי המשאב משתמש.
השלבים הבאים
במאמר תחילת העבודה כמפתחים ב-Workspace מוסבר על פיתוח עם ממשקי API של Google Workspace, כולל טיפול באימות ובהרשאה.
כדי ללמוד איך להגדיר ולהפעיל אפליקציית Directory API פשוטה, נסו את המדריך למתחילים של JavaScript.