Method: courses.patch

更新課程的一或多個欄位。

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

  • PERMISSION_DENIED 如果要求使用者未獲准修改所要求的課程，或發生存取錯誤。
  • NOT_FOUND：如果沒有與要求 ID 相符的課程。
  • INVALID_ARGUMENT：如果更新遮罩中指定的欄位無效，或未提供更新遮罩，則傳回此值。
  • FAILED_PRECONDITION 適用於下列要求錯誤：
    • CourseNotModifiable
    • InactiveCourseOwner
    • IneligibleOwner

HTTP 要求

PATCH https://classroom.googleapis.com/v1/courses/{id}

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

路徑參數

參數
id

string

要更新的課程 ID。這個 ID 可以是 Classroom 指派的 ID 或 alias。

查詢參數

參數
updateMask

string (FieldMask format)

用於識別要更新的課程欄位。這是更新時的必填欄位。如果指定無效欄位，更新作業會失敗。以下欄位有效：

  • name
  • section
  • descriptionHeading
  • description
  • room
  • courseState
  • ownerId

注意：系統會立即生效 ownerId 的修補程式，但實際上，所有受影響資源的擁有權轉移作業可能需要一段時間才能完成。

在查詢參數中設定時，應將此欄位指定為

updateMask=<field1>,<field2>,...

這是以半形逗號分隔的完整欄位名稱清單。範例："user.displayName,photo"。

要求主體

要求主體包含 Course 的例項。

回應主體

如果成功，回應主體會包含 Course 的執行例項。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱授權指南。