בדף הזה מוסבר על האירועים ב-Google Meet שהאפליקציה שלכם יכולה להירשם אליהם באמצעות Google Workspace Events API. אחרי שתחליטו אילו סוגי אירועים אתם צריכים, תוכלו ליצור מינויים כדי להתחיל לקבל אירועים מ-Google Meet.
מידע נוסף על פיתוח אפליקציות ל-Google Meet זמין בסקירה הכללית על Google Meet API ל-REST.
סוגי האירועים הנתמכים ב-Meet
מינויים ל-Google Workspace מאפשרים לכם לקבל אירועים לגבי סוגי השינויים הבאים ב-Meet:
- ועידה מתחילה או מסתיימת במרחב משותף.
- משתתף מצטרף או יוצא משיחה קבוצתית.
- נוצרת הקלטה של ועידה.
- המערכת יוצרת תמליל של שיחת ועידה.
משאבים שאפשר לעקוב אחר אירועים שלהם
כדי לקבל אירועים, צריך לציין משאב ב-Meet שרוצים לעקוב אחריו. המשאב הזה נקרא משאב היעד של המינוי.
ב-Google Workspace Events API יש תמיכה במשאבי היעד הבאים ב-Meet:
| משאב היעד | אופן הלימוד | מגבלות (אם רלוונטי) |
|---|---|---|
| מקום לפגישה | //meet.googleapis.com/spaces/SPACE
כאשר SPACE הוא המזהה ב
שם המשאב של משאב |
|
| משתמש | //cloudidentity.googleapis.com/users/USER
כאשר USER הוא המזהה בשדה
|
המינויים מקבלים אירועים לגבי מרחבי עבודה משותפים שבהם המשתמש הוא:
|
סוגי אירועים ליצירת מינויים
כשיוצרים מינוי למשאב ב-Meet, משתמשים בשדה eventTypes[] כדי לציין את סוגי האירועים שרוצים לקבל. סוגי האירועים בפורמט לפי מפרט CloudEvents, למשל google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.
לדוגמה, כדי לקבל אירועים על משתתפים חדשים בכנס במרחב משותף ב-Meet, צריך לציין את סוג האירוע בתור google.workspace.meet.participant.v2.joined. מידע נוסף על אירועים זמין במאמר המבנה של אירועים ב-Google Workspace.
בטבלה הבאה מפורטים סוגי האירועים הנתמכים, תיאור שלהם והמשאב המשתנה ב-Meet שמיוצג בנתוני האירוע:
| סוג האירוע | תיאור | משאב בנושא Meet |
|---|---|---|
|
תיפתח ועידה במרחב המשותף. |
|
|
שיחת ועידה מסתיימת במרחב האירועים. |
|
|
משתתף מצטרף לכנס פעיל במרחב הפגישה. |
|
|
משתתף יוצא מכנס פעיל במרחב הפגישה. |
|
|
קובץ ההקלטה נוצר עבור ועידה במרחב המשותף לפגישות. |
|
|
קובץ תמליל נוצר עבור ועידה במרחב המשותף לפגישות. |
|
נתוני אירוע
בקטע הזה מתוארים נתוני אירועים ודוגמאות לעומסי נתונים (payloads) של אירועים במרחבי הפגישות ב-Meet.
כשמינוי Google Workspace מקבל אירוע מ-Meet, השדה data מכיל את עומס העבודה של האירוע. בעומס התועלת הזה יש מידע על המשאב ב-Google Workspace שהשתנה. לדוגמה, אם נרשמת לאירועים על תמלילים חדשים במרחב משותף, עומס העבודה של האירועים האלה מכיל מידע על המשאב transcript שהשתנה.
נתוני המשאבים בתוכן של האירוע
בטבלה הבאה מפורטות דוגמאות לעומסי נתונים (payloads) של JSON למינוי למרחב משותף לפגישות ב-Meet. בדוגמאות נעשה שימוש בפגישה conferenceRecords/AAA-BBB-CCC-DDD-EEE שמתקיימת במרחב המשותף. לכל אירוע שהמינויים מקבלים, עומס העבודה מופיע בשדה data של האירוע:
| דוגמה | סוג האירוע | מטען ייעודי (payload) של JSON |
|---|---|---|
התחילה ועידה במרחב הווירטואלי של Meet. |
|
לא כולל נתוני משאבים
{
"conferenceRecord":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
}
}
|
| משתתף מצטרף לפגישה במרחב המשותף ב-Meet. |
|
לא כולל נתוני משאבים
{
"participantSession":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP"
}
}
|
| ההקלטה נוצרת לפגישה בפורום במרחב העבודה של Meet. | google.workspace.meet.recording.v2.fileGenerated |
לא כולל נתוני משאבים
{
"recording":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP"
}
}
|
| התמליל של כנס נוצר במרחב הפגישה ב-Meet. | google.workspace.meet.transcript.v2.fileGenerated |
לא כולל נתוני משאבים
{
"transcript":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT"
}
}
|