Method: courses.students.create

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

網域管理員可以直接新增所屬網域中的使用者，以學生形式加入網域中的課程。學生可以使用註冊代碼自行加入課程。

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

  • PERMISSION_DENIED：提出要求的使用者不允許在這門課程中建立學生，或是存取錯誤。
  • 如果要求的課程 ID 不存在，則為 NOT_FOUND。
  • 如果要求的使用者的帳戶遭到停用，則會發生下列要求錯誤：
      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

詳情請參閱授權指南。