במדריך הזה מוסבר איך להשתמש בשיטה 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.