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