REST Resource: courses.courseWork

資源：CourseWork

老師為課程學生建立的課程作業。

JSON 表示法 
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },

  // Union field details can be only one of the following:
  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  // End of list of possible types for union field details.
}
欄位
courseId

string

課程的 ID。

唯讀。
id

string

Classroom 指派給這個課程作業的 ID，每個課程均不得重複。

唯讀。
title

string

課程作業的標題。標題必須是 UTF-8 字串，且長度必須介於 1 至 3000 個字元之間。
description

string

此為本課程作業的說明 (選填)。如有設定，則說明必須是有效的 UTF-8 字串，且最多只能包含 30,000 個半形字元。
materials[]

object (Material)

其他資料。

CourseWork 最多只能包含 20 個教材項目。
state

enum (CourseWorkState)

這個課程作業的狀態。如果未指定，則預設狀態為 DRAFT。
creationTime

string (Timestamp format)

建立這個課程作業時的時間戳記。

唯讀。

RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateTime

string (Timestamp format)

此課程作業最近變更的時間戳記。

唯讀。

RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
dueDate

object (Date)

這項課程作業的繳交期限 (選用日期，以世界標準時間為準)。如果已指定 dueTime，則必須指定這個值。
dueTime

object (TimeOfDay)

這項課程作業的交件期限 (選用) (使用世界標準時間)。如果已指定 dueDate，則必須指定這個值。
scheduledTime

string (Timestamp format)

(選填) 這課程作業預定發布時的時間戳記。

RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
maxPoints

number

這項課程作業的最高成績。如未指定或未指定，作業將視為未評分。此值必須為非負整數。
workType

enum (CourseWorkType)

這個課程作業的類型。

類型會在建立課程作業時設定，而且無法變更。
associatedWithDeveloper

boolean

這個課程工作項目是否與提出要求的開發人員控制台專案相關聯。

詳情請參閱 courseWork.create。

唯讀。
assigneeMode

enum (AssigneeMode)

課程作業的指派對像模式。如果未指定，則預設值為 ALL_STUDENTS。
individualStudentsOptions

object (IndividualStudentsOptions)

具有課程作業存取權的學生 ID。只有在 assigneeMode 為 INDIVIDUAL_STUDENTS 時，才需要設定此欄位。如果 assigneeMode 為 INDIVIDUAL_STUDENTS，則只有這個欄位中指定的學生會指派課程作業。
submissionModificationMode

enum (SubmissionModificationMode)

這項設定可決定學生何時可以修改繳交的作業。如果未指定，則預設值為 MODIFIABLE_UNTIL_TURNED_IN。
creatorUserId

string

建立課程作業的使用者 ID。

唯讀。
topicId

string

與這項課程相關聯的主題 ID。必須與課程中的現有主題相符。
gradeCategory

object (GradeCategory)

這項課程的成績所屬的類別。只有在已選擇課程作業的類別時才會顯示。可用於計算總成績。

唯讀。
聯集欄位 details。特定課程作業類型專屬的其他詳細資料。details 只能是下列其中一項：
assignment

object (Assignment)

作業詳細資料。只有在 workType 為 ASSIGNMENT 時，系統才會填入這個值。

唯讀。
multipleChoiceQuestion

object (MultipleChoiceQuestion)

選擇題問題詳細說明。如果是讀取作業，只有在 workType 為 MULTIPLE_CHOICE_QUESTION 時，才會填入此欄位。針對寫入作業，使用 MULTIPLE_CHOICE_QUESTION 的 workType 建立課程工作時，必須指定此欄位，否則不得設定此欄位。

CourseWorkState

課程作業的可能狀態。

列舉
COURSE_WORK_STATE_UNSPECIFIED 未指定州。系統絕不會傳回這個內容。
PUBLISHED 已發布工作的狀態，此為預設狀態。
DRAFT 尚未發布的作品狀態。只有課程老師和網域管理員看得到這個狀態的工作。
DELETED 已發布工作的狀態，但目前已刪除。只有課程老師和網域管理員看得到這個狀態的工作。系統稍後會刪除處於這個狀態的工作。

SubmissionModificationMode

可供學生繳交作業的修改模式。

列舉
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED 未指定修改模式。系統絕不會傳回這個內容。
MODIFIABLE_UNTIL_TURNED_IN 您可以在繳交前修改繳交的內容。
MODIFIABLE 提交資料可隨時修改。

指派項目

作業的其他詳細資料。

JSON 表示法 
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
欄位
studentWorkFolder

object (DriveFolder)

要存放學生繳交作業的雲端硬碟資料夾。這個欄位僅供課程老師和管理員使用。

MultipleChoiceQuestion

選擇題的其他詳細資料。

JSON 表示法 
{
  "choices": [
    string
  ]
}
欄位
choices[]

string

可能的選擇。

方法

create

 建立課程作業。

delete

 刪除課程作業。

get

 傳回課程作業。

getAddOnContext

 取得 Classroom 外掛程式與特定訊息相關的中繼資料。

list

 傳回允許要求者查看的課程作業清單。

modifyAssignees

 修改課程的指派對像模式和選項。

patch

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