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