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

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

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

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

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

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

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

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

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

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

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

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

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

המנוי מקבל אירועים לגבי כל המרחבים לפגישות שבהם המשתמש הוא הבעלים של המרחב לפגישות. בדרך כלל, הבעלים של חדר הפגישות הוא גם המארגן של האירוע ביומן 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.smartNote.v2.started conferenceRecord.smartNote
סיכום חכם מסתיים בפגישה במרחב הפגישה. google.workspace.meet.smartNote.v2.ended conferenceRecord.smartNote
קובץ סיכום חכם נוצר לשיחה בוועידה במרחב הפגישה. google.workspace.meet.smartNote.v2.fileGenerated conferenceRecord.smartNote
תמליל מתחיל לוועידה במרחב הפגישה. 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 מכיל את מטען הנתונים של האירוע. מטען הנתונים הזה מכיל מידע על משאב Google Workspace שהשתנה. לדוגמה, אם נרשמתם לקבלת עדכונים על אירועים שקשורים לתמלילים חדשים במרחב, מטען הנתונים של האירועים האלה יכיל מידע על משאב transcripts שהשתנה.

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

בטבלה הבאה מופיעות דוגמאות למטענים ייעודיים (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.smartNote.v2.started
  • google.workspace.meet.smartNote.v2.ended
  • google.workspace.meet.smartNote.v2.fileGenerated

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

{
  "smartNote":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/smartNotes/SMART_NOTE_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.workspace.meet.conference.v2.started ו-google.workspace.meet.transcript.v2.fileGenerated.