במדריך הזה מוסבר איך להשתמש בשיטה create() במשאב Reaction של Google Chat API כדי להוסיף תגובה להודעה – כמו 👍, 🚲 ו-🌞.
המשאב Reaction מייצג אמוג'י שאנשים יכולים להשתמש בו כדי להגיב להודעה, כמו 👍, 🚲 ו-🌞.
דרישות מוקדמות
Node.js
- חשבון Google Workspace במהדורת Business או Enterprise עם גישה ל-Google Chat.
- מגדירים את הסביבה:
- יוצרים פרויקט ב-Google Cloud.
- מגדירים את מסך ההסכמה של OAuth.
- מפעילים ומגדירים את Google Chat API עם שם, סמל ותיאור לאפליקציית Chat.
- מתקינים את ספריית הלקוח של Cloud ל-Node.js.
-
יצירת פרטי כניסה של מזהה לקוח OAuth לאפליקציה למחשב. כדי להריץ את הדוגמה במדריך הזה, שומרים את פרטי הכניסה כקובץ JSON בשם
credentials.jsonבספרייה המקומית.
- בוחרים היקף הרשאה שתומך באימות משתמשים.
הוספת תגובה להודעה
כדי ליצור תגובה להודעה, מעבירים את הפרטים הבאים בבקשה:
- מציינים את היקף ההרשאה
chat.messages.reactions.create,chat.messages.reactionsאוchat.messages. - קוראים לשיטה
CreateReaction()ומעבירים אתparentכשם המשאב של ההודעה שאליה רוצים להגיב, ואתreactionכמופע שלReactionשבו השדהunicodeהוא אמוג'י רגיל שמיוצג על ידי מחרוזת Unicode.
בדוגמה הבאה מוצגת תגובה להודעה באמצעות האימוג'י 😀:
Node.js
כדי להריץ את הדוגמה הזו, מחליפים את הערכים הבאים:
-
SPACE_NAME: המזהה מnameשל המרחב. אפשר לקבל את המזהה על ידי הפעלת השיטהListSpaces()או מכתובת ה-URL של המרחב. -
MESSAGE_NAME: המזהה מתוךnameשל ההודעה. אפשר לקבל את המזהה מגוף התגובה שמוחזר אחרי יצירת הודעה באופן אסינכרוני באמצעות Chat API, או באמצעות שם מותאם אישית שהוקצה להודעה בזמן היצירה.
Chat API מחזיר מופע של Reaction עם פרטים על התגובה שנוצרה.