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

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

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

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

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

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

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

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

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

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

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

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

המנוי מקבל אירועים לגבי כל המרחבים לפגישות שבהם המשתמש הוא הבעלים של המרחב לפגישות. בדרך כלל, הבעלים של חדר הפגישות הוא גם המארגן של האירוע ביומן Google שמשויך לחדר הפגישות.

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

כשיוצרים מינוי למשאב ב-Meet, משתמשים בשדה eventTypes[] כדי לציין אילו סוגי אירועים רוצים לקבל. סוגי האירועים מעוצבים בהתאם למפרט CloudEvents, כמו google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.

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

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

סוג האירוע אופן הלימוד נתוני משאבים
שיחת הוועידה מתחילה במרחב הפגישה. google.meet.conference.v2.started conferenceRecord
השיחה מסתיימת במרחב הפגישה. google.meet.conference.v2.ended conferenceRecord
משתתף מצטרף לפגישה פעילה במרחב הפגישה. google.meet.participant.v2.joined conferenceRecord.participantSession
משתתף עוזב את הפגישה הפעילה במרחב הפגישה. google.meet.participant.v2.left conferenceRecord.participantSession
קובץ הקלטה נוצר לשיחת ועידה במרחב הפגישות. google.meet.recording.v2.fileGenerated conferenceRecord.recording
קובץ תמליל נוצר לשיחת ועידה במרחב הפגישה. google.meet.transcript.v2.fileGenerated conferenceRecord.transcript

נתוני אירוע

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

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

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

בטבלה הבאה מופיעות דוגמאות למטענים ייעודיים (payloads) של JSON להרשמה למרחב לפגישות ב-Meet. בדוגמאות נעשה שימוש במזהה של רשומת הפגישה (לדוגמה, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) כדי לזהות את מקום הפגישה. מידע נוסף זמין במאמר איך Meet מזהה מרחב פגישות.

עבור כל אירוע שהמינוי מקבל, מטען הייעודי (payload) מופיע בשדה data של האירוע:

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

מתחילה ועידה במרחב הפגישות ב-Meet.

google.workspace.meet.conference.v2.started
לא כולל נתוני משאבים
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
משתתף מצטרף לוועידה במרחב הפגישה ב-Meet.

google.workspace.meet.participant.v2.joined
לא כולל נתוני משאבים
{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
הקלטה נוצרת לוועידה במרחב הפגישה ב-Meet. google.workspace.meet.recording.v2.fileGenerated
לא כולל נתוני משאבים
{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
תמליל נוצר לפגישה במרחב לפגישות ב-Meet. google.workspace.meet.transcript.v2.fileGenerated
לא כולל נתוני משאבים
{
    "transcript":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
    }
}

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