Method: courses.students.create

將使用者新增為課程的學生。

網域管理員可以直接將網域內的使用者新增為課程學生。學生可以使用註冊代碼將自己加入課程。

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

  • PERMISSION_DENIED 如果要求使用者未獲准在課程中建立學生，或因存取錯誤而發生。
  • NOT_FOUND：如果要求的課程 ID 不存在。
  • FAILED_PRECONDITION 如果要求的使用者帳戶已停用，則會發生以下要求錯誤：
    • CourseMemberLimitReached
    • CourseNotModifiable
    • UserGroupsMembershipLimitReached
    • InactiveCourseOwner
  • ALREADY_EXISTS 如果使用者已是課程的學生或老師。

HTTP 要求

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

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

路徑參數

參數
courseId

string

要建立學生的課程 ID。這個 ID 可以是 Classroom 指派的 ID 或 alias。

查詢參數

參數
enrollmentCode

string

要建立學生的課程註冊代碼。如果 userId 對應於要求使用者，就必須使用這個程式碼；如果要求使用者具備管理員權限，可為任何使用者建立學生，則可省略這個程式碼。

要求主體

要求主體包含 Student 的例項。

回應主體

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

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/classroom.rosters
  • https://www.googleapis.com/auth/classroom.profile.emails
  • https://www.googleapis.com/auth/classroom.profile.photos

詳情請參閱授權指南。