איך משיבים להזמנות לאירועים מ-Google Meet

במאמר הזה מוסבר איך לקבל אירועים מ-Google Meet מ-Google Cloud Pub/Sub ולהגיב להם.

אירוע ב-Meet מייצג פעילות או שינוי במשאב של Meet, כמו יצירת פגישה חדשה. אתם יכולים להשתמש באירועים כדי להבין מה קרה ואז לפעול, או כדי להגיב בצורה משמעותית למשתמשים.

ריכזנו כאן כמה דוגמאות לשימוש באירועים:

  • לצפות בשינויים בפגישה ולהגיב להם, למשל כשפגישה מתחילה או מסתיימת.

  • לבדוק מי השתתף בפגישה למטרות רגולטוריות או לצורך הדרכה.

  • האזנה לתמליל הפגישה כדי שתוכן הקובץ יוכל לעבור ניתוח ולהירשם במערכת לניהול קשרי לקוחות (CRM) או במסד נתונים.

הסבר על אירועים

בכל פעם שמשהו קורה ב-Google Meet, נוצר או מתעדכן משאב של Google Meet REST API. ‫Meet משתמש באירועים כדי להעביר מידע לאפליקציה על סוג הפעילות שהתרחשה, ועל המשאב של Meet REST API שהושפע.

ב-Meet, האירועים מסווגים לפי סוג. סוגי האירועים עוזרים לכם לסנן ולקבל רק את סוג המידע שאתם צריכים, ומאפשרים לכם לטפל בפעילויות דומות באותו אופן.

בדוגמה הבאה אפשר לראות איך פעילות ב-Meet משפיעה על משאב קשור ב-API ל-REST של Meet, ועל סוג האירוע שאפליקציית Meet מקבלת:

פעילות הכרת משאב REST API סוג אירוע
משתמש מצטרף למרחב פגישות. נוצר משאב ConferenceRecord. תיעוד חדש של שיחות הוועידה

קבלת נתוני אירועים מ-Google Meet

כדי לקבל נתוני אירועים, האפליקציה יכולה לבצע אחת מהפעולות הבאות:

בטבלה הבאה מוסבר ההבדל בין הרשמה לאירועים לבין שליחת שאילתות לגביהם, וגם הסיבות להרשמה לאירועים:

הרשמה לעדכונים על אירועים שאילתה לנתונים
תרחישים לדוגמה
  • לסיים את הטיפול באירועים או להגיב להם בזמן אמת.
  • כדאי לעקוב אחרי שינויים במשאבים כדי לשפר את הביצועים של האפליקציה.
  • אחזור נתונים באופן ידני.
  • שליפת כל הנתונים מ-Meet (בגלל הפסקת שירות או מינוי לא פעיל).
API Google Workspace Events API ‫Meet REST API
מקור האירועים המאזן בתוך האזור והמשתמשים מאזן בתוך האזור
אירועים נתמכים הקלטת שיחה בוועידה

רשימה של סוגי האירועים הנתמכים מופיעה במאמר סוגי אירועים ליצירת מינויים במסמכי התיעוד של Google Workspace Events API. 		הקלטה של מרחב ושל שיחה בוועידה

רשימה של נקודות הקצה הנתמכות מופיעה במשאב Space ובמשאב ConferenceRecord במאמרי העזרה של Meet REST API.
פורמט האירוע הודעה ב-Google Cloud Pub/Sub, בפורמט לפי המפרט של CloudEvent. פרטים נוספים מופיעים במאמר בנושא המבנה של אירועים ב-Google Workspace. משאב של Meet REST API ‏ (Space ו-ConferenceRecord)
נתוני אירוע מחרוזת בקידוד Base64 עם נתוני משאבים או בלי. דוגמאות למטענים ייעודיים (payload) זמינות במאמר בנושא נתוני אירועים. מטען ייעודי (payload) של JSON שמכיל נתוני משאבים. דוגמה למטען ייעודי (payload) אפשר לראות במאמרי העזרה של ConferenceRecord .

מגבלות
  • רק המשתתפים שהוזמנו לפגישה דרך יומן Google ומשתתפים אחרים שהוזמנו לשיחת הוועידה יכולים לקבל את האירועים הבאים: google.workspace.meet.conference.v2.started ו-google.workspace.meet.transcript.v2.fileGenerated.