הרשמה לאירועים של Google Meet

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

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

סוגי האירועים הנתמכים ב-Meet

מינויים ל-Google Workspace מאפשרים לכם לקבל אירועים לגבי סוגי השינויים הבאים ב-Meet:

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

משאבים שאפשר לעקוב אחר אירועים שלהם

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

Google Workspace Events API תומך במשאבי היעד הבאים ב-Meet:

משאב היעד אופן הלימוד מגבלות (אם רלוונטי)
מקום לפגישה //meet.googleapis.com/spaces/SPACE

כאשר SPACE הוא המזהה ב שם המשאב של משאב space ב-Meet API ל-REST. מידע נוסף זמין במאמר איך Meet מזהה מרחבים משותפים לפגישות.
משתמש //cloudidentity.googleapis.com/users/USER

כאשר USER הוא המזהה בשדה signedinUser.user של המשאב participant ב-Meet API ל-REST. למידע נוסף, קראו את המאמר עבודה עם משתתפים.

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

  • הבעלים של מרחב הישיבות.
  • משתתף במרחב המשותף של הפגישה.
  • מארגן האירוע ביומן Google שמשויך למרחב האירועים.

סוגי אירועים ליצירת מינויים

כשיוצרים מינוי למשאב ב-Meet, משתמשים בשדה eventTypes[] כדי לציין את סוגי האירועים שרוצים לקבל. סוגי האירועים בפורמט לפי מפרט CloudEvents, למשל google.workspace.APPLICATION.RESOURCE.VERSION.ACTION. לדוגמה, כדי לקבל עדכונים על משתתפים חדשים בכנס במרחב משותף ב-Meet, צריך לציין את סוג האירוע בתור google.workspace.meet.participant.v2.joined. מידע נוסף על אירועים זמין במאמר המבנה של אירועים ב-Google Workspace.

בטבלה הבאה מפורטים סוגי האירועים הנתמכים, תיאור שלהם והמשאב המשתנה ב-Meet שמיוצג בנתוני האירוע:

סוג האירוע תיאור מקור מידע בנושא Meet

google.workspace.meet.conference.v2.started

תיפתח שיחת ועידה במרחב המשותף.

conferenceRecord

google.workspace.meet.conference.v2.ended

פגישה מסתיימת במרחב האירועים.

conferenceRecord

google.workspace.meet.participant.v2.joined

משתתף מצטרף לכנס פעיל במרחב הפגישה.

conferenceRecord.participantSession

google.workspace.meet.participant.v2.left

משתתף יוצא מכנס פעיל במרחב הפגישה.

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

קובץ ההקלטה נוצר עבור ועידה במרחב המשותף לפגישות.

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

ייוצר קובץ תמליל של שיחת ועידה במרחב המשותף לפגישות.

conferenceRecord.transcript

נתוני אירוע

בקטע הזה מתוארים נתוני אירועים ודוגמאות לעומסי נתונים (payloads) של אירועים במרחבי הפגישות ב-Meet.

כשמינוי Google Workspace מקבל אירוע מ-Meet, השדה data מכיל את עומס העבודה של האירוע. בעומס הייעודי הזה יש מידע על המשאב ב-Google Workspace שהשתנה. לדוגמה, אם נרשמת לאירועים על תמלילים חדשים במרחב משותף, עומס העבודה של האירועים האלה מכיל מידע על המשאב transcript שהשתנה.

נתוני המשאבים במטען הייעודי של האירוע

בטבלה הבאה מפורטות דוגמאות למטענים ייעודיים (payloads) של JSON עבור הרשמה למרחב שיתופי לפגישות ב-Meet. בדוגמאות נעשה שימוש בפגישה conferenceRecords/AAA-BBB-CCC-DDD-EEE שמתקיימת במרחב המשותף. לכל אירוע שהמינוי מקבל, עומס העבודה מופיע בשדה data של האירוע:

דוגמה סוג האירוע מטען ייעודי (payload) של JSON

תיפתח ועידה במרחב הווירטואלי של Meet.

google.workspace.meet.conference.v2.started

לא כולל נתוני משאבים:

{
    "conferenceRecord":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
    }
}
משתתף מצטרף לפגישה במרחב המשותף ב-Meet.

google.workspace.meet.participant.v2.joined

לא כולל נתוני משאבים:

{
    "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"
    }
}