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

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

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

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

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

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

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

איך אירועים פועלים

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

דוגמה לאופן שבו מרחב חדש לפגישות מפעיל אירוע.
איור 1. משתמש יוצר מרחב לפגישה, וכך נוצר משאב Space. ‫Meet יוצר אירוע שמכיל נתונים על חלל הפגישות החדש.

ב-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 .

דוגמה: שליפת אירועים שקשורים למשתתפים במרחב פגישות

בדוגמה הזו, אפליקציה של Meet רוצה לקבל מידע על שינויים במשתתפים במרחב הפגישה. במרחב הפגישה, משתתף מצטרף לוועידה פעילה, שמאכלסת משאב ParticipantSession ומפעילה אירוע חדש. אחרי זה תוכלו לקבל מידע על האירועים האלה באמצעות השיטה subscribe או query.

הרשמה לעדכונים על אירועים

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

אפליקציית Meet שנרשמת לאירועי משתתפים באמצעות Google Workspace Events API.
איור 2. אפליקציית Meet מקבלת אירועים של משתתפים דרך מינוי באמצעות Google Workspace Events API.

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

מידע על יצירת מינויים באמצעות Google Workspace Events API זמין במסמכי התיעוד של Google Workspace Events API.

שליחת שאילתה לגבי אירועים מהזמן האחרון

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

אפליקציית Meet שמבצעת שאילתות לגבי אירועים של משתתפים באמצעות Meet REST API.
איור 3. אפליקציית Meet מקבלת אירועים עדכניים של משתתפים על ידי שליחת שאילתה לגבי אירועים במרחב הפגישה באמצעות Meet REST API.

באיור 3, אפליקציית Meet קוראת ל-method של Meet REST API‏ conferenceRecords.participants.participantSessions.list אחרי שכל הפעילויות של הסשן של המשתתפים התרחשו. ‫Meet REST API מחזיר רשימה של משאבי ParticipantSession שמייצגים כל אחד מהשינויים. אפליקציית Meet יכולה לעבד את הפעילות האחרונה או להגיב לה, למשל ליצור רשימה של המשתתפים שהצטרפו לשיחה ועזבו אותה.

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

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