Method: courses.create

建立課程。

ownerId 中指定的使用者是所建立課程的擁有者,並會新增為老師。如果要求者不是管理員,只能建立以自己為擁有者的課程。網域管理員可以建立網域內任何使用者擁有的課程。

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

  • PERMISSION_DENIED 如果要求的使用者沒有建立課程的權限,或發生存取錯誤
  • NOT_FOUND 如果主要授課老師不是有效使用者。
  • FAILED_PRECONDITION 如果課程擁有者的帳戶已停用,或是發生下列要求錯誤
    • UserCannotOwnCourse
    • UserGroupsMembershipLimitReached
    • CourseTitleCannotContainUrl
  • ALREADY_EXISTS (如果別名已在 id 中指定)。

HTTP 要求

POST https://classroom.googleapis.com/v1/courses

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

要求主體

要求主體包含 Course 的例項。

回應主體

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

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱授權指南