תיווך חיבור WebRTC לשיחת הועידה הפעילה במרחב המשותף.
אם הפעולה תתבצע בהצלחה, הלקוחות יצטרכו להשתמש בתשובה שתתקבל מ-SDP (Session Description Protocol) כדי ליצור חיבור WebRTC. אחרי ההתחברות, פונקציונליות נוספת זמינה בערוצי הנתונים של WebRTC.
בקשת HTTP
POST https://meet.googleapis.com/v2beta/{name=spaces/*}:connectActiveConference
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
name |
חובה. שם המשאב של המרחב המשותף. פורמט: spaces/{spaceId} |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
---|
{ "offer": string } |
שדות | |
---|---|
offer |
חובה. הצעה של WebRTC SDP (Session Description Protocol) מהלקוח. הפורמט מוגדר ב-RFC 8866 עם מפתחות חובה שמוגדרים ב-RFC 8829. זהו הפורמט הסטנדרטי של SDP שנוצר על ידי השיטות createOffer() ו-createAnswer() של חיבור עמית. |
גוף התשובה
התגובה של השיטה spaces.connectActiveConference.
תגובה על הצלחה לא מציינת שהצטרפות לפגישה הושלמה. צריך להמשיך את התקשורת דרך WebRTC.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
---|
{ "answer": string, "traceId": string } |
שדות | |
---|---|
answer |
תשובת WebRTC SDP להצעה. |
traceId |
מזהה מעקב לצורכי ניפוי באגים. יש לכלול את הערך הזה בדיווח על באגים. |
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/meetings.conference.media.readonly
https://www.googleapis.com/auth/meetings.conference.media.audio.readonly
https://www.googleapis.com/auth/meetings.conference.media.video.readonly
מידע נוסף זמין בOAuth 2.0 Overview.