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

יצירת מרחב ב-Google Meet באמצעות השיטה spaces.create

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

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

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

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

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

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

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

Meet API בארכיטקטורת REST יוצר משאב 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 (Session Initiation Protocol) למרחב הזה בפגישה. כתובת SIP מפרטת איך ציוד לשיחות ועידה בווידאו של צדדים שלישיים יכול למצוא ולהצטרף לשיחת ועידה ב-Meet. האובייקט gatewaySipAccess מכיל URI וקוד גישה מספרי. ‫Meet תומך בסכימת SIP URI.

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

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

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

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

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

היקפי הרשאות OAuth לפי תרחיש לדוגמה

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

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

תרחיש שימוש קוד היקף
הגדרת יצירה אוטומטית של ארטיפקטים למרחבים שנוצרו על ידי אפליקציות אחרות. https://www.googleapis.com/auth/meetings.space.settings
קבלת פריטי מידע שנוצרו מפגישות שנוצרו על ידי אפליקציות אחרות או הצגת רשימה שלהם. https://www.googleapis.com/auth/meetings.space.readonly
קבלת או הצגת הגדרות אחרות של מרחב לפגישות שנוצר על ידי אפליקציית צד שלישי, לפני הפגישה. https://www.googleapis.com/auth/meetings.space.created
https://www.googleapis.com/auth/meetings.space.readonly
קריאה ועריכה של ההגדרות של כל המרחבים לפגישות שמשתמש יכול לגשת אליהם דרך כל אפליקציה אחרת, כמו יומן Google. https://www.googleapis.com/auth/meetings.space.settings

רשימה מלאה של כל ההיקפים הנתמכים ורמות הרגישות של ההרשאות שלהם מופיעה במאמר היקפי Meet API בארכיטקטורת REST.

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

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

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

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

  2. איך יוצרים סקר במרחב החדש לפגישות מבצעים קריאה ל-method‏ 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 של אובייקט הארטיפקט מאוכלס ומוחזר כחלק מאובייקט המשאב.