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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

סוג האירוע תיאור מקור מידע על 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.fileGenerated

קובץ הקלטה נוצר לשיחת ועידה במרחב הפגישות.

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

קובץ תמליל נוצר עבור שיחת ועידה במרחב הפגישה.

conferenceRecord.transcript

נתוני אירוע

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

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

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

בטבלה הבאה מופיעות דוגמאות למטענים ייעודיים (payloads) של JSON להרשמה למרחב לפגישות ב-Meet. בדוגמאות נעשה שימוש במזהה של הקלטת שיחת הוועידה (לדוגמה, conferenceRecords/AAA-BBB-CCC-DDD-EEE) כדי לזהות את המרחב של הפגישה. מידע נוסף זמין במאמר איך 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"
    }
}