איך משיבים להזמנות לאירועים מ-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 משפיעה על משאב קשור ב-API בארכיטקטורת REST של Meet, ועל סוג האירוע שאפליקציית Meet מקבלת:

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

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

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

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

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

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

רשימה של נקודות הקצה הנתמכות מופיעה במשאב Space ובמשאב ConferenceRecord במאמרי העזרה של Meet API בארכיטקטורת REST.
פורמט האירוע הודעה ב-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 API בארכיטקטורת REST כדי לקבל רשימה של אירועים אחרונים במרחב הפגישה שקשורים לפעילות של המשתתפים.

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

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

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

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