בדף הזה מוסבר איך משתמשים ב-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
כדי ליצור מרחב משותף לקהל יעד ספציפי, משתמשים בשיטה create() או בשיטה setup() במשאב Space. כדי להפוך מרחב משותף קיים לגלוי לכולם, משתמשים בשיטה update() במשאב Space. אפשר לשתף עם קהלים ייעודיים רק מרחבים משותפים עם שם, ולכן סוג המרחב המשותף (שמיוצג בשדה spaceType) חייב להיות SPACE.
כדי שהמרחב יהיה גלוי לקהל היעד, צריך לכלול את האובייקט AccessSettings במשאב Space כחלק מהבקשה ל-Chat API. מציינים את השדה audience באובייקט:
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
מחליפים את TARGET_AUDIENCE_ID במזהה הקהל היעד שקיבלתם בקטע הקודם. כדי להשתמש בהגדרות ברירת המחדל של שיתוף המרחבים המשותפים ב-Chat בארגון שלכם ב-Google Workspace, מחליפים את הערך ב-default.
למידע נוסף על יצירת מרחבים משותפים או עדכון שלהם באמצעות Chat API, תוכלו לעיין במדריכים הבאים: