הרשמה לאירועים של 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.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.started conferenceRecord.recording
ההקלטה מסתיימת בפגישה במרחב הפגישות. google.workspace.meet.recording.v2.ended conferenceRecord.recording
קובץ הקלטה נוצר לשיחת ועידה במרחב הפגישות. google.workspace.meet.recording.v2.fileGenerated conferenceRecord.recording
תמליל מתחיל להיווצר לשיחת הוועידה במרחב הפגישה. google.workspace.meet.transcript.v2.started conferenceRecord.transcript
התמלול מסתיים בוועידה במרחב הפגישה. google.workspace.meet.transcript.v2.ended conferenceRecord.transcript
קובץ תמליל נוצר לשיחת ועידה במרחב הפגישה. google.workspace.meet.transcript.v2.fileGenerated conferenceRecord.transcript

נתוני אירוע

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

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

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

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

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

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

שיחת ועידה מתחילה או מסתיימת במרחב הפגישות ב-Meet.
  • google.workspace.meet.conference.v2.started
  • google.workspace.meet.conference.v2.ended

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

{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
משתתף מצטרף לוועידה או עוזב אותה במרחב הפגישה ב-Meet.
  • google.workspace.meet.participant.v2.joined
  • google.workspace.meet.participant.v2.left

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

{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
הקלטה מתחילה, מסתיימת או נוצר קובץ עבור ועידה במרחב הפגישה ב-Meet.
  • google.workspace.meet.recording.v2.started
  • google.workspace.meet.recording.v2.ended
  • google.workspace.meet.recording.v2.fileGenerated

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

{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
תמליל מתחיל, מסתיים או שנוצר קובץ עבור ועידה במרחב הפגישה ב-Meet.
  • google.workspace.meet.transcript.v2.started
  • google.workspace.meet.transcript.v2.ended
  • 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.