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

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

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

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

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

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

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

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

כדי לקבל אירועים, צריך לציין משאב של 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:

נתוני אירוע

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

כשהמינוי שלכם ל-Google Workspace מקבל אירוע מ-Meet, השדה data מכיל את המטען הייעודי (payload) של האירוע. המטען הייעודי (payload) הזה מכיל מידע על המשאב של 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.workspace.meet.conference.v2.started ו-google.workspace.meet.transcript.v2.fileGenerated.

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

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