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