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

詳情請參閱授權指南。