סקירה כללית על מרחבי הפגישות ב-Google Meet

‫Google Meet REST API illustration

במדריך הזה מוסבר איך אפשר ליצור ולנהל פגישות ב-Google Meet באמצעות Google Meet REST API.

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

איך יוצרים ומנהלים מרחבים לפגישות במאמר הגדרת מרחבים לפגישות ומשתתפים מוסבר איך להגדיר מרחבים לפגישות באופן פרוגרמטי.

איך מתקשרים לשיטות של המרחב לפגישות

בטבלה הבאה מפורטים התפקידים בפגישה שנדרשים כדי להשתמש בשיטות של מרחב הפגישה:

שיטה בעלים משתתפים אחרים
endActiveConference x
get x x x
     עם הגדרות x
     עם שיחת ועידה פעילה x x
patch x

איך Meet מזהה את מקום הפגישה

‫Google Meet REST API יוצר משאב spaces לכל מרחב פגישה. למשאב spaces יש כמה נקודות כניסה להצטרפות לוועידה.

בטבלה הבאה מוסבר איך לזהות את המרחב לפגישות ולהצטרף אליו:

שם השדה תיאור
name שם המרחב. המחרוזת {space} היא מזהה המשאב של המרחב, והיא מעוצבת כ-spaces/{space}. זהו מזהה ייחודי שנוצר בשרת, והוא תלוי אותיות רישיות. לדוגמה: spaces/jQCFfuBOdN5z.
meetingCode הכינוי של שם המרחב. הערך {meetingCode} הוא מחרוזת תווים ייחודית שאפשר להקליד, והוא לא תלוי באותיות רישיות. הפורמט הוא spaces/{meetingCode}. לדוגמה: spaces/abc-mnop-xyz. האורך המקסימלי הוא 128 תווים. היא חלק מהקטע meetingUri: https://meet.google.com/abc-mnop-xyz.
phoneAccess שיטות הגישה באמצעות הטלפון למרחב הפגישה הזה. אובייקט phoneAccess מכיל את המידע שנדרש כדי לחייג לוועידה, כולל מספרי הטלפון האזוריים של המרחב לפגישות וקוד אימות שספציפי למספר הטלפון הזה. קוד האימות מורכב רק מספרות עשרוניות, והאורך שלו עשוי להשתנות. לדוגמה, "pin": 19707127300.

בדומה לממשק המשתמש של Meet, המשאב spaces כולל קבוצה מוגבלת של מספרי טלפון להצטרפות לפגישה. כדי לראות מספרי טלפון נוספים של מרחב הפגישות, מוסיפים את {meetingCode} לכתובת ה-URL הבאה: https://meet.google.com/tel/. לדוגמה, https://meet.google.com/tel/abc-mnop-xyz.
gatewaySipAccess שיטות הגישה של פרוטוקול אתחול השיחה (SIP) למרחב הזה בפגישה. כתובת SIP מפרטת איך ציוד לשיחות ועידה בווידאו של צד שלישי יכול למצוא ולהצטרף לשיחת ועידה ב-Meet. האובייקט gatewaySipAccess מכיל URI וקוד גישה מספרי. ‫Meet תומך בסכימת SIP URI.

כדי לנהל מרחב פגישות, משתמשים בערכים הבאים בשדה name:

  • כדי לקבל פרטים על מתחם ישיבות, אפשר להשתמש ב-spaces/{space} או בכינוי spaces/{meetingCode}. מידע נוסף זמין במאמר בנושא קבלת חדר פגישות.

  • כדי לעדכן את הפרטים של חלל פגישות, אפשר להשתמש רק ב-spaces/{space}. מידע נוסף זמין במאמר בנושא עדכון של חלל לפגישות.

  • כדי לסיים שיחת ועידה פעילה במרחב לפגישות, אפשר להשתמש רק ב-spaces/{space}. מידע נוסף זמין במאמר בנושא סיום שיחות ועידה פעילות.

מחזור החיים של מרחב משותף לפגישות

במהלך מחזור החיים של מרחב הפגישות, הוא עובר כמה מצבים. התרשים הבא מציג את השלבים הכלליים במחזור החיים של מרחב פגישות:

מחזור החיים של מתחם לפגישות.
איור 1. מחזור החיים של מתחם לפגישות.

  1. שיחה אל spaces.create. המרחב לפגישה נוצר ואובייקט spaces שמוחזר מכיל את המחרוזת meetingUri. אחר כך, meetingUri מופץ למשתתפים.

  2. איך יוצרים סקר במרחב החדש לפגישות מפעילים את השיטה spaces.get כדי לבדוק את מצב שיחת הוועידה.

    במקום להשתמש בסקרים, אפשר גם להירשם לאירועים ב-Meet כדי לקבל התראות פוש.

  3. מתחילים את שיחת הוועידה. כשמשתתף ראשון לוחץ על meetingUri בתוך מרחב הפגישה, מתחילה ועידה. אובייקט activeConference מאוכלס ומחרוזת activeConference.conferenceRecord מוגדרת.

  4. (אופציונלי) קבלת נתונים על שיחות ועידה. במהלך ועידה פעילה, אפשר לגשת לחלק מהערכים של conferenceRecord. לדוגמה, אפשר להתקשר לשיטה conferenceRecords.participants.list כדי לראות את כל המשתתפים בוועידה. אפשר גם לגשת למידע הזה עד 30 יום אחרי הוועידה.

  5. (אופציונלי) סיום שיחת הוועידה. במהלך הוועידה, בעל הפגישה יכול להתקשר לשיטת spaces.endActiveConference כדי לסיים באופן פרוגרמטי ועידה פעילה לכל המשתתפים.

  6. השיחה מסתיימת. הוועידה מסתיימת כשהמשתתף האחרון עוזב אותה.

  7. סקר לגבי פריטים שייווצרו מהפגישה. השיחה הסתיימה (STATE=ENDED), אבל עדיין לא נוצרו הארטיפקטים. גם השדות startTime ו-endTime של הכנס מאוכלסים. צריך לשלוח בקשות לנקודת הקצה של פריט המידע שנוצר בתהליך הפיתוח (Artifact) עד שאובייקט פריט המידע STATE יקרא FILE_GENERATED.

    במקום להשתמש בסקרים, אתם יכולים להירשם לאירועים ב-Meet כדי לקבל התראות פוש.

  8. איך מקבלים פריטי מידע שנוצרו מהפגישה אחרי שנוצרים ארטיפקטים כמו הקלטות ותמלילים, אפשר לאחזר אותם. לדוגמה, אפשר להפעיל את method‏ conferenceRecords.recordings.get כדי לקבל הקלטה לפי מזהה ההקלטה.

    כשהוא מוכן, ה-URI של אובייקט הארטיפקט מאוכלס ומוחזר כחלק מאובייקט המשאב.