במדריך הזה מוסבר איך להשתמש בשיטה get()
במשאב SpaceNotificationSetting
של Google Chat API כדי לקבל את הגדרות ההתראות של המשתמש במרחב.
SpaceNotificationSetting
resource הוא משאב יחיד שמייצג פרטים על הגדרות ההתראות של מרחב מסוים של משתמש.
דרישות מוקדמות
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
של המרחב.
אפשר לקבל את המזהה על ידי הפעלת השיטה ListSpaces()
או מכתובת ה-URL של המרחב.
Google Chat API מקבל את הגדרות ההתראות של המרחב שצוין ומחזיר מופע של SpaceNotificationSetting
.