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 וגם של משאבים, המיוצגים על ידי משאב משתמש.
השלבים הבאים
כדי ללמוד על פיתוח עם Google Workspace APIs, כולל טיפול אימות והרשאה, מתייחסים מתחילים לעבוד כמפתחים של Workspace.
כדי ללמוד איך להגדיר ולהפעיל אפליקציה פשוטה של Directory API, אפשר לנסות את מדריך JavaScript למתחילים.