בדף הזה נספק סקירה כללית על האופן שבו אדמינים ב-Google Workspace יכולים להשתמש ב-Google Chat API כדי לנהל מרחבים משותפים ב-Google Chat בארגון.
כדי לנהל מרחבים משותפים ב-Chat, אדמינים ב-Google Workspace יכולים להשתמש בכלי לניהול מרחבים משותפים במסוף Google Admin או לבצע קריאה ל-Google Chat API. באמצעות Chat API, האדמינים יכולים ליצור אפליקציות ל-Google Chat לניהול מרחבים משותפים בקנה מידה נרחב, ולבצע אוטומציה של משימות נפוצות או משימות שניתן לחזור עליהן.
מה אדמינים יכולים לעשות עם Chat API
אדמין יכול לבצע משימות ניהוליות בהתאם לתפקידים שהוקצו לו.
כאדמינים ב-Google Workspace, אתם יכולים לבצע מספר משימות ניהול באמצעות Chat API, למשל:
- חיפוש מרחבים משותפים לפי קריטריונים מסוימים
- הצגת רשימת המשתתפים במרחב המשותף
- להוסיף אנשים למרחב המשותף ולהסיר אנשים ממנו
- הצגת פרטים על משתתף ועל מרחב משותף
- עדכון או מחיקה של מרחב משותף
- עדכון החברות של משתמש
איך מבצעים אימות והרשאה כאדמינים ב-Google Workspace
כשמשתמשים ב-Chat API למשימות ניהול, האדמינים יכולים לאמת ולתת הרשאה לבקשות על ידי הפעלת הרשאות אדמין או הגדרת הענקת גישה ברמת הדומיין של הרשאה לחשבון השירות של האפליקציה.
בטבלה הבאה מפורטות הדרכים שבהן אדמינים יכולים לבצע אימות כשהם משתמשים ב-Chat API.
| אימות משתמשים | מי קורא לשיטת ה-API | מה המשתמשים רואים ב-Chat |
|---|---|---|
| הרשאות אדמין | אדמין עם useAdminAccess=true
|
"האדמין של הארגון ביצע [פעולה]." לדוגמה, "האדמין של הארגון שינה את התפקיד של Kiran B למנהל המרחב המשותף". הוא לא מזהה את השם או מזהה המשתמש של משתמש האדמין, או את השם של אפליקציית Chat. |
| הענקת גישה ברמת הדומיין | חשבון שירות מטעם משתמש |
"[משתמש] ביצע [פעולה] דרך [שם האפליקציה]." לדוגמה, "Sasha T שינתה את שם המרחב המשותף ל'דיון בנושא פרויקט השקה'". המשתמש שהשירות מתחזה אליו מזוהה כמי שביצע את הפעולה. |
שימוש ב-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().
התכונה הזו יכולה להיות שימושית כשעובדים עוברים בין צוותים בארגון או כשעובדים עוזבים את הארגון. היא מאפשרת לאדמינים לבצע אוטומציה של תהליך שגרתי.
העלאת משתמשים לתפקיד 'מנהל/ת המרחב המשותף'
באמצעות 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 של הארגון, ואז לסנן את התוצאות לפי משתמשים שהם חברים בדומיין או בארגון חיצוני.
מידע נוסף זמין במאמר איך מתבצע זיהוי משתמשים בצ'אט.
ביקורת וניהול של מרחבים משותפים
התרחישים הבאים הם דרכים שבהן אדמינים ב-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()