בדף הזה מתוארים האירועים ב-Google Meet שהאפליקציה שלכם יכולה להירשם אליהם באמצעות Google Workspace Events API. אחרי שתחליטו אילו סוגי אירועים אתם צריכים, תוכלו ליצור מינוי כדי להתחיל לקבל אירועים מ-Meet.
מידע נוסף על פיתוח אפליקציות ל-Meet זמין בסקירה הכללית על API ל-REST של Google Meet.
סוגי האירועים הנתמכים ב-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"
}
}
|