במדריך הזה נסביר איך להשתמש בשיטה get()
במשאב SpaceNotificationSetting
של Google Chat API כדי לקבל את הגדרות ההתראות של המשתמש במרחב המשותף.
משאב SpaceNotificationSetting
הוא משאב יחיד שמייצג פרטים על הגדרות ההתראות של המרחב המשותף של משתמש מסוים.
דרישות מוקדמות
Node.js
- חשבון Google Workspace בתוכנית Business או Enterprise עם גישה ל-Google Chat.
- מגדירים את הסביבה:
- יוצרים פרויקט ב-Google Cloud.
- מגדירים את מסך ההסכמה של OAuth.
- מפעילים ומגדירים את Google Chat API עם שם, סמל ותיאור לאפליקציית Chat.
- מתקינים את ספריית הלקוח של Cloud ל-Node.js.
-
יצירת פרטי כניסה של מזהה לקוח OAuth לאפליקציה למחשב. כדי להריץ את הדוגמה במדריך הזה, שומרים את פרטי הכניסה כקובץ JSON בשם
credentials.json
בספרייה המקומית.
- בחירת היקף הרשאה שתומך באימות משתמשים.
קבלת הגדרות ההתראות של המרחב המשותף של המשתמש המתקשר
כדי לקבל פרטים על הגדרות ההתראות של משתמש במרחב משותף, צריך לכלול בבקשה את הפרטים הבאים:
- מציינים את היקף ההרשאה
chat.users.spacesettings
. - קוראים לשיטה
GetSpaceNotificationSetting()
ומעבירים אתname
של הגדרות ההתראות של המרחב המשותף, כדי לקבל את המזהה שכולל מזהה משתמש או כינוי וגם מזהה מרחב משותף. אתם יכולים לקבל רק את הגדרות ההתראות של המשתמש שמתקשר אליכם. כדי לציין את ההגדרות, משתמשים באחת מהאפשרויות הבאות:- הכינוי
me
. לדוגמה,users/me/spaces/SPACE_ID/spaceNotificationSetting
. - כתובת האימייל של המשתמש הקורא ב-Google Workspace. לדוגמה,
users/user@example.com/spaces/SPACE_ID/spaceNotificationSetting
. - מזהה המשתמש של מבצע הקריאה. לדוגמה,
users/USER/spaces/SPACE/spaceNotificationSetting
.
- הכינוי
בדוגמה הבאה מקבלים את הגדרות ההתראות של המרחב המשותף של המשתמש המתקשר:
Node.js
כדי להריץ את הדוגמה הזו, מחליפים את SPACE_ID
במזהה של name
במרחב המשותף.
אפשר לקבל את המזהה על ידי קריאה ל-method ListSpaces()
או מכתובת ה-URL של המרחב המשותף.
Google Chat API מקבל את הגדרות ההתראות שצוינו למרחב המשותף ומחזיר מופע של SpaceNotificationSetting
.