Method: courses.studentGroups.create

為課程建立學生群組。

這個方法會傳回下列錯誤代碼：

  • PERMISSION_DENIED 如果要求的使用者沒有建立學生群組的權限，或發生存取錯誤。
  • NOT_FOUND：如果課程不存在，或要求的使用者無權存取課程。
  • FAILED_PRECONDITION 建立學生群組會超出每個課程的學生群組數量上限。

HTTP 要求

POST https://classroom.googleapis.com/v1/courses/{courseId}/studentGroups

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

路徑參數

參數
courseId

string

必要欄位。課程的 ID。

查詢參數

參數
previewVersion

enum (PreviewVersion)

(選用步驟) API 的預覽版本。您必須設定這個值，才能存取開發人員預覽計畫中提供的新 API 功能。

要求主體

要求主體包含 StudentGroup 的例項。

回應主體

如果成功，回應主體會包含新建立的 StudentGroup 例項。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/classroom.rosters

詳情請參閱授權指南。