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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

רשימה של נקודות הקצה הנתמכות מופיעה במשאב Space ובמשאב ConferenceRecord במאמרי העזרה של Meet REST API.
פורמט האירוע הודעה ב-Google Cloud Pub/Sub, בפורמט לפי המפרט של CloudEvent. פרטים נוספים מופיעים במאמר בנושא המבנה של אירועים ב-Google Workspace. משאב של Meet API בארכיטקטורת REST‏ (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 זמין במאמרי העזרה של ה-API של Google Workspace Events.

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

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

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

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

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

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