Method: courses.courseWork.modifyAssignees

修改課程作業的指派模式和選項。

只有包含作業的課程老師可以呼叫這個方法。

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

  • PERMISSION_DENIED 如果要求存取的使用者沒有權限存取要求的課程或課程作業,或是發生存取錯誤
  • INVALID_ARGUMENT:要求格式錯誤。
  • 如果要求的課程或課程作業不存在,則為 NOT_FOUND
  • FAILED_PRECONDITION,因為發生下列要求錯誤
    • EmptyAssignees

HTTP 要求

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

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

路徑參數

參數
courseId

string

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

id

string

作業的 ID。

要求主體

要求主體的資料會採用以下結構:

JSON 表示法
{
  "assigneeMode": enum (AssigneeMode),
  "modifyIndividualStudentsOptions": {
    object (ModifyIndividualStudentsOptions)
  }
}
欄位
assigneeMode

enum (AssigneeMode)

課程作業模式,說明作業是會指派給所有學生,還是特定學生。

modifyIndividualStudentsOptions

object (ModifyIndividualStudentsOptions)

設定要指派或不指派哪些學生修習課程。只有在 assigneeModeINDIVIDUAL_STUDENTS 時,才必須指定。

回應主體

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

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱授權指南