Method: courses.studentGroups.studentGroupMembers.create

為學生群組建立學生群組成員。

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

  • PERMISSION_DENIED 如果要求的使用者無權為存取錯誤建立學生群組或成員。
  • NOT_FOUND 如果學生群組不存在，或使用者沒有學生群組的存取權。
  • ALREADY_EXISTS (如果學生群組成員已存在)。
  • FAILED_PRECONDITION 如果嘗試將成員新增至成員人數已達上限的學生群組。

HTTP 要求

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

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

路徑參數

參數
courseId

string

必要欄位。課程的 ID。
studentGroupId

string

必要欄位。學生群組的 ID。

查詢參數

參數
previewVersion

enum (PreviewVersion)

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

要求主體

要求主體包含 StudentGroupMember 的例項。

回應主體

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱授權指南。