בדף הזה מוסבר איך משתמשים ב-Google Chat API כדי לשתף מרחב משותף ב-Google Chat עם משתמשים ספציפיים בארגון ב-Google Workspace, כדי שהם יוכלו למצוא את המרחב המשותף ולהצטרף אליו.
כדי לציין את המשתמשים בארגון שיכולים למצוא מרחב משותף ולהצטרף אליו, צריך ליצור קהלים יעד. קהל יעד הוא קבוצה של אנשים, כמו מחלקות ספציפיות או הארגון כולו, שאפשר לשתף איתם מרחב ב-Chat כדי לשפר את המוּדעוּת ואת יכולת השיתוף של המרחב. משתמשי היעד מאפשרים גם לנהל ולהתאים אישית את החברויות במרחבים משותפים, במקום להזמין משתמשים ספציפיים למרחבים משותפים. למידע נוסף, ראו מידע על קהלים ייעודיים.
אפשר להגדיר רק מרחבים משותפים עם שם שגלויים לקהלי היעד. אי אפשר לשתף עם קהלים טירגוטיים סוגים אחרים של מרחבים משותפים, כמו צ'אטים אישיים או שיחות קבוצתיות.
דרישות מוקדמות
- חשבון Google Workspace בתוכנית Business או Enterprise עם גישה ל-Google Chat. לחשבון שלכם צריכה להיות תפקיד סופר-אדמין בארגון ב-Google Workspace.
- קהל יעד שזמין לגישה ב-Chat. במאמר יצירה של קהל יעד מוסבר איך יוצרים קהל יעד. כדי לאפשר לקהל יעד קיים להצטרף למרחבים משותפים ב-Chat, תוכלו לעיין במאמר הגדרת גישה למרחבים ב-Chat.
- צריך לבצע קריאה ל-Google Chat API עם אימות משתמש.
אחזור המזהה של קהל היעד
כדי לקבל את המזהה של קהל היעד:
במסוף Google Admin, נכנסים אל תפריט > ספרייה > קהלים יעד.
בטבלה Target audiences (קהלי יעד), לוחצים על השדה Name (שם) של קהל היעד.
המזהה של קהל היעד נמצא בכתובת ה-URL של הדף. פורמט כתובת ה-URL הוא
https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID, כאשרTARGET_AUDIENCE_IDהוא המזהה האלפאנומרי של קהל היעד.
בקטע הבא תלמדו איך להשתמש במזהה של קהל היעד כדי ליצור מרחב גלוי לכולם או לעדכן מרחב קיים כך שיהיה גלוי לקהל היעד.
ציון קהל היעד בבקשה ל-Chat API
כדי ליצור מרחב לקהל יעד ספציפי, משתמשים ב-method create() או
setup() במשאב Space. כדי להפוך מרחב משותף קיים לגלוי לכולם, משתמשים בשיטה update() במשאב Space. אפשר לשתף עם קהלים ייעודיים רק מרחבים משותפים עם שם, ולכן סוג המרחב המשותף (שמיוצג בשדה spaceType) חייב להיות SPACE.
כדי להגדיר מרחב משותף שגלוי לקהל היעד, אתם צריכים לכלול את האובייקט AccessSettings במשאב Space כחלק מבקשת ה-API ל-Chat. מציינים את השדה audience באובייקט:
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
מחליפים את TARGET_AUDIENCE_ID במזהה הקהל היעד שקיבלתם בקטע הקודם. כדי להשתמש בהגדרות ברירת המחדל של שיתוף מרחב משותף ב-Chat ברמת הארגון ב-Google Workspace, צריך להחליף את ההגדרה ב-default.
למידע נוסף על יצירה ועדכון של מרחבים באמצעות Chat API, אפשר להיעזר במדריכים הבאים: