更新課程作業的一或多個欄位。
如要進一步瞭解哪些欄位可以更新,以及哪些欄位可以變更,請參閱 google.classroom.v1.CourseWork
。
這項要求必須由用來建立相應的課程作業項目的 OAuth 用戶端 ID 的 Developer Console 專案提出。
這個方法會傳回下列錯誤代碼:
PERMISSION_DENIED
如果提出要求的開發人員專案並未建立相應的課程作業、使用者無法依要求修改學生繳交的內容,或發生存取錯誤- 如果要求格式錯誤,則為
INVALID_ARGUMENT
。 - 如果所要求的課程作業已遭刪除,請
FAILED_PRECONDITION
。 NOT_FOUND
如果要求的課程、作業或學生繳交的作業不存在。
HTTP 要求
PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{id}
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
courseId |
課程的 ID。這個 ID 可以是 Classroom 指派的 ID 或 |
id |
課程作業的 ID。 |
查詢參數
參數 | |
---|---|
updateMask |
這個遮罩可識別課程作業中要更新的欄位。此為必填欄位,才能進行更新。如果指定無效欄位,更新就會失敗。如果欄位支援空白值,只要在更新遮罩中指定 (而不是在 以下欄位可由老師指定:
此為以半形逗號分隔的完整欄位名稱清單。範例: |
要求主體
要求主體包含 CourseWork
的例項。
回應主體
如果成功,回應主體會包含 CourseWork
的執行例項。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/classroom.coursework.students
詳情請參閱授權指南。