Method: spaces.connectActiveConference

將 WebRTC 連線仲介至聊天室的有效會議。

成功後，用戶端必須使用產生的 SDP (工作階段描述協定) 答案，建立 WebRTC 連線。連線完成後，您就能在 WebRTC 資料管道中使用其他功能。

HTTP 要求

POST https://meet.googleapis.com/v2beta/{name=spaces/*}:connectActiveConference

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

必要欄位。聊天室的資源名稱。格式：spaces/{spaceId}

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "offer": string
}
欄位
offer

string

必要欄位。來自用戶端的 WebRTC SDP (會話描述協定) 提供項目。

格式由 RFC 8866 定義，其中的必要鍵則由 RFC 8829 定義。這是由對等連線的 createOffer() 和 createAnswer() 方法產生的標準 SDP 格式。

回應主體

spaces.connectActiveConference 方法的回應。

成功回應並非表示會議已完全加入；必須透過 WebRTC 進行進一步的通訊。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "answer": string,
  "traceId": string
}
欄位
answer

string

WebRTC SDP 對提案的回應。
traceId

string

用於偵錯的追蹤 ID。請在回報錯誤時附上這個值。

授權範圍

需要下列其中一種 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。