הרשמה לאירועים של 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:

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

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

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

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

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

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

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

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

נתוני אירוע

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

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

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

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

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

{
  "conferenceRecord":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID"
  }
}
      

{
  "participantSession":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
  }
}
      

{
  "recording":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
  }
}
      

{
  "smartNote":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/smartNotes/SMART_NOTE_ID"
  }
}
      

{
  "transcript":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
  }
}
      

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

נושאים קשורים

• סקירה כללית של Google Workspace Events API
• המבנה של אירועים ב-Google Workspace
• בחירת היקפי הרשאות של Google Workspace Events API
• סקירה כללית על Google Meet REST API
• בחירת היקפי הרשאות של Google Meet REST API
• מדריך: מעקב אחרי אירועים בפגישה באמצעות Python ו-Google Meet REST API