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

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

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

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

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

  • א' שיחת ועידה מתחיל או מסתיים במרחב משותף.
  • א' משתתף הצטרפות לפגישה או יציאה ממנה.
  • א' הקלטה נוצר עבור שיחת ועידה.
  • א' transcript נוצר עבור שיחת ועידה.

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

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

ב-Google Workspace Event API יש תמיכה במשאבי היעד הבאים ל-Meet:

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

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

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

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

  • הבעלים של המרחב המשותף.
  • המארגן של האירוע ביומן 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

נתוני אירוע

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

כשהמינוי שלך ל-Google Workspace מקבל אירוע מ- Meet, data מכיל את המטען הייעודי (payload) של האירוע. המטען הייעודי כולל מידע על המשאב של Google Workspace שהשתנה. לדוגמה, אם נרשמתם ל- אירועים שקשורים לתמלילים חדשים במרחב, המטען הייעודי (Payload) של האירועים האלה מכיל מידע על transcript שהשתנה.

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

בטבלה הבאה מפורטות דוגמאות למטענים ייעודיים (payloads) של JSON עבור מינוי מרחב ישיבות ב-Meet. בדוגמאות נעשה שימוש בשיחת הוועידה conferenceRecords/AAA-BBB-CCC-DDD-EEE שמתרחש במרחב המשותף. לכל אירוע שהמינוי מקבל, המטען הייעודי (Payload) מופיע בשדה 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"
    }
}