בדף הזה מוסבר איך אדמינים ב-Google Workspace יכולים להשתמש ב-Google Chat API כדי לנהל את החללים ב-Google Chat בארגון שלהם.
אדמינים ב-Google Workspace יכולים להשתמש בכלי לניהול מרחבים במסוף Google Admin או להתקשר ל-Google Chat API כדי לנהל את המרחבים ב-Chat. באמצעות Chat API, אדמינים יכולים ליצור אפליקציות ל-Google Chat שמנהלות מרחבים בקנה מידה גדול ומבצעות אוטומטית משימות נפוצות או חוזרות.
מה אדמינים יכולים לעשות עם Chat API
אדמין יכול לבצע משימות ניהול על סמך תפקידי האדמין שהוקצו לו.
אדמינים ב-Google Workspace יכולים לבצע מספר משימות ניהול באמצעות Chat API, כמו:
- חיפוש מרחבים על סמך קריטריונים ספציפיים
- הצגת רשימת המשתתפים במרחב
- איך מוסיפים אנשים למרחבים ומסירים אנשים מהמרחבים
- קבלת פרטים על משתתפים ועל מרחבים
- עדכון או מחיקה של מרחב
- עדכון החברות של משתמש
איך לבצע אימות והרשאה כאדמין ב-Google Workspace
כשמשתמשים ב-Chat API למשימות ניהול, האדמינים יכולים לאמת ולאשר בקשות על ידי הפעלת הרשאות אדמין או על ידי הגדרת הענקת גישה ברמת הדומיין של סמכות לחשבון השירות של האפליקציה.
בטבלה הבאה מפורטות הדרכים שבהן אדמינים יכולים לבצע אימות כשהם משתמשים ב-Chat API.
| אימות משתמשים | מי קורא לשיטת ה-API | מה המשתמשים רואים ב-Chat |
|---|---|---|
| הרשאות אדמין | אדמין עם useAdminAccess=true
|
"האדמין של הארגון ביצע [פעולה]." לדוגמה, 'האדמין של הארגון שינה את התפקיד של Kiran B למנהל/ת המרחב'. הוא לא מזהה את השם או מזהה המשתמש של האדמין, או את השם של אפליקציית Chat. |
| הענקת גישה ברמת הדומיין | חשבון שירות בשם משתמש |
"[User] performed [an action] via [app name]" (המשתמש [שם המשתמש] ביצע [פעולה] באמצעות [שם האפליקציה]). לדוגמה, 'סשה ט שינתה את שם המרחב לדיון על פרויקט ההשקה'. המשתמש שהשירות מתחזה לו מזוהה כמי שביצע את הפעולה. |
שימוש ב-Chat API בארגון
בדוגמאות שבקטע הזה מוסבר איך אדמינים משתמשים ב-Chat API כדי לנהל את המרחבים והמשתתפים בארגון שלהם עם הרשאות אדמין.
השיטות הבאות של Chat API מאפשרות הרשאות אדמין עםuseAdminAccess=true.
spaces.delete()spaces.get()spaces.patch()spaces.search()spaces.members.create()spaces.members.delete()spaces.members.get()spaces.members.list()spaces.members.patch()
ניהול של חברות משתמשים במרחבים
אלה כמה תרחישים שבהם אדמינים ב-Google Workspace יכולים להשתמש ב-Chat API כדי לנהל את החברות במרחבים של משתמשים בארגון.
הוספת משתמשים למרחבים
אדמינים יכולים להשתמש ב-spaces.members.create() כדי להוסיף משתמש לכל מרחב בארגון.
אדמינים יכולים להשתמש בהגדרה הזו בשילוב עם spaces.search() כדי להוסיף משתמש לקבוצת מרחבים שנקבעת לפי שאילתת החיפוש. האפשרות הזו יכולה להיות שימושית כשמצרפים עובדים חדשים לארגון, כי היא מאפשרת לאדמינים לבצע אוטומציה של תהליך שחוזר על עצמו.
חיפוש משתמשים והסרתם ממרחבים
באמצעות spaces.members.get(), אדמינים יכולים לקבוע אם משתמש (פנימי או חיצוני לארגון) הוא חבר במרחב כלשהו בארגון.
אדמינים יכולים להשתמש ב-spaces.search() כדי למצוא את כל המרחבים שהמשתמש חבר בהם, ואז להסיר אותו מהמרחבים באמצעות spaces.members.delete().
האפשרות הזו יכולה להיות שימושית כשעובדים עוברים בין צוותים בארגון או כשמבצעים תהליך Offboarding לעובדים שכבר לא עובדים בארגון. היא מאפשרת לאדמינים לבצע אוטומציה של תהליך שגרתי.
העלאת משתמשים לרמת מנהל/ת המרחב
באמצעות spaces.members.patch(), אדמינים יכולים לשנות את ההרשאה של משתתפים במרחב מROLE_MEMBER לROLE_MANAGER.
אדמינים יכולים גם להשתמש בspaces.members.patch() כדי להעביר חברים מROLE_MANAGER
אל ROLE_MEMBER.
אדמינים יכולים להשתמש ב-spaces.search() כדי למצוא מרחבים שאין להם מנהל, ואז להעניק למשתתף קיים הרשאת ROLE_MANAGER באמצעות spaces.members.patch().
איך מוצאים משתמשים לא מהארגון במרחב
באמצעות spaces.members.list(), אדמינים יכולים לאחזר רשימה של משתתפים במרחב, לאחזר את פרופילי המשתמשים מ-People API או מ-Directory API של הארגון, ואז לסנן את התוצאות כדי לראות מי מהם משתתפים בדומיין או בארגון חיצוניים.
מידע נוסף זמין במאמר איך המשתמשים מזוהים ב-Chat.
ביקורת וניהול של מרחבים
התרחישים הבאים מתארים דרכים שבהן אדמינים ב-Google Workspace יכולים לבדוק ולנהל את המרחבים בארגון באמצעות Chat API.
איך למצוא ולמחוק מרחבים לא פעילים
מרחבים ב-Chat שלא נעשה בהם שימוש יכולים לתפוס נפח אחסון יקר ערך ולגרום לעומס בממשק המשתמש. אדמינים יכולים להשתמש ב-spaces.search() כדי למצוא את המרחבים הלא פעילים, ואז ב-spaces.delete() כדי למחוק אותם. הנחיות נוספות ודוגמת קוד זמינות במאמר חיפוש ומחיקה של מרחבים לא פעילים ב-Chat.
ביקורת במרחבים בארגון
באמצעות spaces.search(), מנהלי מערכת יכולים לאחזר רשימה של כל המרחבים בארגון עם מידע מפורט על ההגדרות והמטא-נתונים של כל מרחב, כמו תאריך היצירה, תאריך הפעילות האחרונה, מספר החברים, הסטטוס של הגדרת ההיסטוריה והיכולת להזמין אורחים חיצוניים.
ייצוא רשימה של מרחבים על סמך קריטריונים לחיפוש
באמצעות spaces.search(), אדמינים יכולים לאחזר רשימה של מרחבים שעומדים בקריטריונים שצוינו ב-query ולייצא את התוצאות לקובץ CSV לצורך ניתוח.
חיפוש חברים במרחב לפי קריטריוני חיפוש
באמצעות spaces.members.list(), אדמינים יכולים לאחזר רשימה של חברים בכל מרחב בארגון ולנתח את התוצאות לפי קריטריונים ספציפיים.
איך מוצאים את המנהלים של המרחב
באמצעות spaces.members.list(), אדמינים יכולים לאחזר רשימה של חברים במרחב, מסוננת לפי MembershipState=ROLE_MANAGER.
כדי למצוא את כל מנהלי המרחבים בארגון, בכל המרחבים, אפשר להשתמש ב-spaces.search() כדי לראות את כולם. לאחר מכן, לכל מרחב ברשימה, משתמשים ב-spaces.members.list כדי לאחזר את המנהלים.
נושאים קשורים
- אימות והרשאה באמצעות הרשאות אדמין
- חיפוש וניהול של מרחבים ב-Google Chat באמצעות Google Chat API כאדמינים ב-Google Workspace
spaces.search()method