本指南說明如何透過 Google Meet REST API 的 spaces 資源建立、取得及更新會議空間,以及結束進行中的會議。
建立會議空間
如要建立會議空間,請使用 spaces 資源的 create 方法。
這個方法會傳回 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 的存取權杖。
取得會議空間的詳細資料
如要取得有效會議空間及其設定的詳細資料,請對 spaces 資源使用 get 方法。請使用 spaces/{space} 或 spaces/{meetingCode} 格式設定 name 路徑參數。詳情請參閱「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 的存取權杖。
將會議空間的空間名稱值替換為伺服器產生的專屬 ID。
更新會議空間
如要更新會議空間的詳細資料,請使用 spaces 資源的 patch 方法。請使用 spaces/{space} 格式設定 space.name 路徑參數。詳情請參閱「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 的存取權杖。
將會議空間的空間名稱值替換為伺服器產生的專屬 ID。
結束進行中的會議
如要結束會議空間 (如有) 內的現有會議,請使用 spaces 資源的 endActiveConference 方法。請使用 spaces/{space} 格式設定 name 路徑參數。要求和回應主體皆為空白。詳情請參閱「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 的存取權杖。
將會議空間的空間名稱值替換為伺服器產生的專屬 ID。