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

詳情請參閱授權指南