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

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

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

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

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