במדריך הזה מוסבר איך ליצור, לקבל ולעדכן מרחב לפגישות, ואיך לסיים שיחת ועידה פעילה במשאב spaces של Google Meet REST API.
יצירת מרחב לפגישה
כדי ליצור מרחב פגישות, משתמשים ב-method create במשאב spaces.
השיטה מחזירה מופע של משאב spaces, שכולל את האובייקט SpaceConfig שהוא ההגדרה של מרחב הפגישות. הוא מכיל גם את האובייקט ActiveConference שהוא קישור למשאב conferenceRecords הנוכחי במרחב הפגישה.
בדוגמת הקוד הבאה אפשר לראות איך יוצרים מרחב פגישות:
Java
Node.js
Python
cURL
curl -X POST "https://meet.googleapis.com/v2/spaces" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
מחליפים את ACCESS_TOKEN באסימון הגישה שמעניק גישה ל-API.
איך מקבלים פרטים על מרחב פגישות
כדי לקבל פרטים על מרחב פעיל לפגישות ועל ההגדרות שלו, משתמשים בשיטה get במשאב spaces. מגדירים את פרמטר הנתיב name באמצעות הפורמט spaces/{space} או spaces/{meetingCode}. מידע נוסף זמין במאמר איך Meet מזהה חדר ישיבות.
השיטה מחזירה מרחב פגישות כמופע של המשאב spaces. כדי לקבוע אם יש שיחת ועידה פעילה, בודקים את השדה activeConference.
בדוגמת הקוד הבאה אפשר לראות איך מאחזרים מרחב פגישות:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/spaces/SPACE_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
מחליפים את ACCESS_TOKEN באסימון הגישה שמעניק גישה ל-API.
מחליפים את הערך של שם המרחב במזהה הייחודי שנוצר על ידי השרת עבור המרחב לפגישות.
עדכון של מרחב לפגישות
כדי לעדכן את הפרטים של מרחב פגישות, משתמשים בשיטה patch במשאב spaces. מגדירים את פרמטר הנתיב space.name בפורמט spaces/{space}. מידע נוסף מופיע במאמר איך Meet מזהה חדר ישיבות.
השיטה patch מקבלת גם פרמטר שאילתה אופציונלי updateMask. השדה הוא מסוג FieldMask.
זו רשימה מופרדת בפסיקים של השדות שרוצים לעדכן במרחב.
השיטה מחזירה מרחב פגישות כמופע של המשאב spaces.
בדוגמת הקוד הבאה אפשר לראות איך מעדכנים מרחב פגישות:
Java
Node.js
Python
cURL
curl -X PATCH "https://meet.googleapis.com/v2/spaces/SPACE_NAME?updateMask=config.accessType" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"config": {
"accessType": "RESTRICTED"
}
}'
מחליפים את ACCESS_TOKEN באסימון הגישה שמעניק גישה ל-API.
מחליפים את הערך של שם המרחב במזהה הייחודי שנוצר על ידי השרת עבור המרחב לפגישות.
סיום שיחת הוועידה הפעילה
כדי לסיים שיחה פעילה במרחב פגישות (אם יש כזה), משתמשים בשיטה endActiveConference במשאב spaces.
מגדירים את פרמטר הנתיב name באמצעות הפורמט spaces/{space}. גם גוף הבקשה וגם גוף התשובה ריקים. מידע נוסף זמין במאמר איך Meet מזהה חדר פגישות.
בדוגמת הקוד הבאה אפשר לראות איך מסיימים שיחת ועידה פעילה:
Java
Node.js
Python
cURL
curl -X POST "https://meet.googleapis.com/v2/spaces/SPACE_NAME:endActiveConference" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
מחליפים את ACCESS_TOKEN באסימון הגישה שמעניק גישה ל-API.
מחליפים את הערך של שם המרחב במזהה הייחודי שנוצר על ידי השרת עבור המרחב לפגישות.