您的使用者是透過 Classroom 使用 Google Meet 嗎?請參閱 Apps Script 快速入門,瞭解如何查看學生在 Google Meet 課程中的出席狀況

Method: courses.students.create

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

系統允許網域管理員在自己的網域中直接新增使用者,加入網域內課程。學生可以使用註冊代碼將自己加入課程。

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

  • 如果要求的使用者不允許在課程中建立學生,或是發生存取錯誤,則為 PERMISSION_DENIED
  • 如果要求的課程 ID 不存在,會傳回 NOT_FOUND
  • 如果要求的使用者帳戶遭到停用,則為 FAILED_PRECONDITION,且發生下列要求錯誤
    • 課程的成員人數達到上限
    • 課程不可修改
    • 已達使用者群組成員資格上限
    • 閒置課程擁有者
  • 如果使用者是課程中的學生或老師,則為 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

詳情請參閱 OAuth 2.0 總覽