Method: courses.courseWork.create

建立課程作業。

最終產生的課程作業 (以及對應的學生繳交的內容) 與用來提出要求的 OAuth 用戶端 ID 的 Developer Console 專案相關聯。如要透過 Classroom API 要求修改課程作業和學生繳交的內容，必須使用相關聯 Developer Console 專案的 OAuth 用戶端 ID。

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

  • PERMISSION_DENIED：如果要求的使用者無權存取指定的課程、在指定課程中建立課程作業、共用雲端硬碟附件或發生存取錯誤，則可以這麼做。
  • 如果要求格式錯誤，則為 INVALID_ARGUMENT。
  • 如果要求的課程不存在，則為 NOT_FOUND。
  • 下列要求錯誤則為 FAILED_PRECONDITION：
    • AttachmentNotVisible

HTTP 要求

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork

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

路徑參數

參數
courseId

string

課程的 ID。這個 ID 可以是 Classroom 指派的 ID，也可以是alias。

查詢參數

參數
previewVersion

enum (PreviewVersion)

選用設定。端點的預先發布版。完成這項設定後，才能存取搶先體驗方案為開發人員提供的全新 API 功能。

要求主體

要求主體包含 CourseWork 的例項。

回應主體

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

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/classroom.coursework.students

詳情請參閱授權指南。