Method: courses.create

建立課程。

ownerId 中指定的使用者是建立課程的擁有者,並已新增為老師。非管理員的申請者只能建立自己為擁有者的課程。網域管理員可以建立網域中任何使用者擁有的課程。

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

  • PERMISSION_DENIED 如果要求使用者未獲准建立課程,或發生存取錯誤
  • NOT_FOUND 表示主要授課老師不是有效使用者。
  • FAILED_PRECONDITION 如果課程擁有者的帳戶遭到停用,或是發生下列要求錯誤
    • UserCannotOwnCourse
    • UserGroupsMembershipLimitReached
  • ALREADY_EXISTS,如果在 id 中指定了別名且該別名已存在。

HTTP 要求

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

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

要求主體

要求主體包含 Course 的例項。

回應主體

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

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱授權指南