בדף הזה מוסבר איך להשתמש ב-Google Chat API כדי לשתף מרחב ב-Google Chat עם משתמשים ספציפיים בארגון Google Workspace, כדי שהם יוכלו לגלות את המרחב ולהצטרף אליו.
כדי לציין את המשתמשים בארגון שיכולים לגלות ולהצטרף למרחב, צריך ליצור קהלי יעד. קהל היעד הוא קבוצה של אנשים – כמו מחלקות ספציפיות או כל הארגון – שאפשר לשתף איתם מרחב ב-Chat כדי לשפר את המודעות למרחב ואת האפשרות לשתף אותו. בנוסף, משתמשי יעד מאפשרים לכם לנהל ולהתאים אישית את החברות במרחב, במקום להזמין משתמשים ספציפיים למרחב. מידע נוסף זמין במאמר מידע על קהלים ממוקדים.
אפשר להפוך מרחבים עם שם לגלויים רק לקהלי יעד. אי אפשר לשתף סוגים אחרים של מרחבים, כמו צ'אטים ישירים או שיחות קבוצתיות, עם קהלים מטורגטים.
דרישות מוקדמות
- חשבון Google Workspace במהדורת Business או Enterprise עם גישה ל-Google Chat. בחשבון שלכם צריך להיות תפקיד סופר-אדמין בארגון שלכם ב-Google Workspace.
- קהל יעד שאפשר לגשת אליו ב-Chat. כדי ליצור קהל יעד, אפשר לעיין במאמר בנושא יצירה של קהל יעד. כדי להפוך קהל יעד קיים לזמין למרחבים ב-Chat, אפשר לעיין במאמר בנושא הגדרת גישה למרחבים ב-Chat.
- צריך לבצע קריאה ל-Google Chat API עם אימות משתמש.
קבלת המזהה של קהל היעד
כדי לקבל את המזהה של קהל יעד:
במסוף Google Admin, נכנסים אל תפריט > ספרייה > קהלים ממוקדים.
בטבלה קהלים לטירגוט, לוחצים על השדה שם של קהל היעד.
מאתרים את מזהה קהל היעד בכתובת ה-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, אפשר לעיין במדריכים הבאים: