使用者是否透過 Google Meet 使用 Classroom？請參閱 Apps Script 快速入門導覽課程，瞭解如何在 Google Meet 課程中查看學生的出席情況。

Method: courses.patch

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

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

  • 如果要求的使用者不允許修改要求的課程或存取錯誤，則為 PERMISSION_DENIED。
  • 如果沒有與要求 ID 相符的課程，則 NOT_FOUND。
  • 如果更新遮罩中指定的欄位無效，或未提供更新遮罩，則 INVALID_ARGUMENT。
  • 下列要求錯誤的 FAILED_PRECONDITION：
    • 課程不可修改
    • 閒置課程擁有者

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

詳情請參閱 OAuth 2.0 總覽。