במדריך הזה מוסבר איך להשתמש
setUp()
במשאב Space
של Google Chat API כדי להגדיר Google Chat
המרחב המשותף. כשיוצרים מרחב משותף, המערכת מוסיפה אליו משתמשים ספציפיים.
המשאבים מסוג Space
מייצגים מקום שבו אנשים ואפליקציות של Chat יכולים לשלוח הודעות, לשתף קבצים ולשתף פעולה. יש כמה סוגים של מרחבים משותפים:
- צ'אטים ישירים הם שיחות בין שני משתמשים או משתמש, אפליקציה ל-Chat.
- שיחות קבוצתיות הן שיחות בין שלושה משתמשים או יותר באפליקציות Chat.
- מרחבים עם שם הם מקומות קבועים שבהם אנשים שולחים הודעות, משתפים קבצים, ולשתף פעולה.
כשמגדירים מרחב משותף, כדאי להביא בחשבון את הנקודות הבאות:
- המשתמש ששלח את השיחה (המאומת) יתווסף אוטומטית למרחב המשותף, כך שאתם לא צריך לציין בבקשה את החברות של המשתמש.
- כשיוצרים צ'אט אישי, אם יש שני משתמשים בצ'אט אישי, הצ'אט מוחזר. אם לא, נוצרת צ'אט.
- כשיוצרים צ'אט קבוצתי, אם לא הזנתם את האנשים שצוינו בבקשה נוספו בהצלחה לצ'אט הקבוצתי (למשל, בעיה בהרשאות), ואז יכול להיות שייווצר צ'אט קבוצתי ריק (כולל רק את המשתמש המתקשר).
- אין לך אפשרות להגדיר מרחבים עם תשובות לשרשורים או לצרף אנשים שלא מהארגון שלך Google Workspace
- חברויות כפולות (כולל המשתמש הקורא) שצוינו בבקשה מסוננות במקום לגרום לשגיאה בבקשה.
דרישות מוקדמות
Node.js
- עסק או ארגון חשבון Google Workspace עם גישה אל Google Chat.
- מגדירים את הסביבה:
- יוצרים פרויקט ב-Google Cloud.
- מגדירים את מסך ההסכמה של OAuth.
- מפעילים ומגדירים את Google Chat API עם שם, סמל ותיאור לאפליקציית Chat.
- מתקינים את ספריית הלקוח של Cloud ל-Node.js.
-
יוצרים פרטי כניסה למזהה הלקוח ב-OAuth לאפליקציה למחשב. כדי להריץ את הדוגמה במדריך הזה, שומרים את פרטי הכניסה כקובץ JSON בשם
client_secrets.json
בספרייה המקומית.
- בחירת היקף הרשאה שתומך באימות משתמשים.
Python
- עסק או ארגון חשבון Google Workspace עם גישה אל Google Chat.
- מגדירים את הסביבה:
- יוצרים פרויקט ב-Google Cloud.
- מגדירים את מסך ההסכמה של OAuth.
- מפעילים ומגדירים את Google Chat API עם שם, הסמל והתיאור של אפליקציית Chat.
- מתקינים את ספריית הלקוח של Cloud ל-Python.
-
יוצרים פרטי כניסה למזהה הלקוח ב-OAuth לאפליקציה למחשב. כדי להריץ את הדוגמה במדריך הזה, שומרים את פרטי הכניסה כקובץ JSON בשם
client_secrets.json
בספרייה המקומית.
- בחירת היקף הרשאה שתומך באימות משתמשים.
Java
- חשבון Google Workspace בתוכנית Business או Enterprise עם גישה ל-Google Chat.
- מגדירים את הסביבה:
- יוצרים פרויקט ב-Google Cloud.
- מגדירים את מסך ההסכמה של OAuth.
- מפעילים ומגדירים את Google Chat API עם שם, סמל ותיאור לאפליקציית Chat.
- להתקין את Java ספריית הלקוח של Cloud.
-
יוצרים פרטי כניסה למזהה הלקוח ב-OAuth לאפליקציה למחשב. כדי להריץ את הדוגמה
שלנו, שומרים את פרטי הכניסה כקובץ JSON בשם
client_secrets.json
הספרייה המקומית.
- בוחרים את היקף ההרשאה שתומך באימות משתמש.
Apps Script
- עסק או ארגון חשבון Google Workspace עם גישה אל Google Chat.
- מגדירים את הסביבה:
- יוצרים פרויקט ב-Google Cloud.
- מגדירים את מסך ההסכמה של OAuth.
- מפעילים ומגדירים את Google Chat API עם שם, סמל ותיאור לאפליקציית Chat.
- יוצרים פרויקט נפרד ב-Apps Script. ומפעילים את שירות Chat המתקדם.
- בחירת היקף הרשאה שתומך באימות משתמשים.
הגדרת מרחב משותף
כדי להגדיר מרחבים משותפים, צריך להעביר את הפרטים הבאים בבקשה:
- מציינים את היקף ההרשאה
chat.spaces.create
אוchat.spaces
. - קוראים לפונקציה
SetUpSpace()
. - מעבירים את
space
כמכונה שלSpace
עם כל השדות הנדרשים, כמוdisplayName
אוspaceType
. - מעבירים את
memberships
כמערך שלMembership
במקרים שונים. בכל אחד מהמופעים:- מציינים את
users/{user}
כדי להוסיף משתמש אנושי כחבר במרחב המשותף, כאשר{user}
הוא{person_id}
שלperson
מ-People API, או המזהה שלuser
ב-Directory API. לדוגמה, אם המשתמש ב-People APIresourceName
הואpeople/123456789
, אפשר להוסיף אותו למרחב המשותף על ידי הוספת חברות עםusers/123456789
כ-member.name
. - מציינים את הערך
groups/{group}
כדי להוסיף קבוצה כחברה במרחב המשותף, כאשר{group}
הוא מזהה הקבוצה שאליה רוצים ליצור חברות. המזהה של הקבוצה ניתן לאחזר באמצעות Cloud Identity API. לדוגמה, אם Cloud Identity API מחזיר קבוצה בשםgroups/123456789
, צריך להגדיר אתmembership.groupMember.name
לערךgroups/123456789
. אי אפשר להוסיף קבוצות מ-Google Groups לצ'אט קבוצתי או לצ'אט אישי, אלא רק למרחב משותף בעל שם.
- מציינים את
כדי ליצור צ'אט אישי בין המשתמש מבצע הקריאה לבין משתמש אנושי אחר, צריך לציין את החברות של המשתמש האנושי בבקשה.
כדי ליצור שיחה פרטית בין המשתמש הקורא לאפליקציה הקוראת, מגדירים את הערך של space.singleUserBotDm
כ-true
ולא מציינים חברויות. אפשר
אפשר להשתמש בשיטה הזו רק כדי להגדיר צ'אט אישי באפליקציית השיחות. כדי להוסיף את השיחה
באפליקציה שלכם במרחב משותף או בצ'אט קיים בין שני משתמשים אנושיים:
יוצרים מינוי.
בדוגמה הבאה נוצר מרחב משותף בשם, ומשתמשים בשני משתמשים אנושיים (המשתמש המאומת ומשתמש נוסף) כחברים במרחב המשותף.
Node.js
Python
Java
Apps Script
כדי להריץ את הדוגמה, מחליפים את מה שכתוב בשדות הבאים:
DISPLAY_NAME
: השם המוצג של המרחב החדש.USER_NAME
: המזהה של המשתמש השני שצריך לכלול עבור חברות ב-Google.
כדי לעבור למרחב המשותף, משתמשים במזהה המשאב של המרחב המשותף כדי ליצור את כתובת ה-URL שלו.
אפשר לאתר את מזהה המשאב מהמרחב המשותף name
בתשובה ב-Google Chat
גוף ההודעה. לדוגמה, אם הערך של name
במרחב המשותף הוא spaces/1234567
, אפשר לבצע את הפעולות הבאות
למרחב באמצעות כתובת ה-URL הבאה:
https://mail.google.com/chat/u/0/#chat/space/1234567
.
נושאים קשורים
- יוצרים מרחב משותף.
- לקבלת פרטים על מרחב משותף
- רשימת המרחבים המשותפים.
- לעדכן מרחב משותף.
- איך מוחקים מרחבים משותפים
- איך מחפשים מרחבים משותפים בצ'אטים ישירים
- להגדיר מרחב משותף כגלוי למשתמשים ספציפיים.