您的使用者是透過 Classroom 使用 Google Meet 嗎?請參閱 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 總覽