REST Resource: courses.courseWork.studentSubmissions

資源：StudentSubmission

學生提交的課程作業。

建立 CourseWork 項目時，系統會產生 StudentSubmission 項目。

如果從未存取學生提交的作業 (即 state = NEW)，系統可能不會顯示建立時間或更新時間。

JSON 表示法 
{
  "courseId": string,
  "courseWorkId": string,
  "id": string,
  "userId": string,
  "creationTime": string,
  "updateTime": string,
  "state": enum (SubmissionState),
  "late": boolean,
  "draftGrade": number,
  "assignedGrade": number,
  "rubricId": string,
  "draftRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "assignedRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  // Union field content can be only one of the following:
  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
  // End of list of possible types for union field content.
}
欄位
courseId

string

課程的 ID。

唯讀。
courseWorkId

string

對應課程作業的 ID。

唯讀。
id

string

Classroom 指派的學生繳交作業 ID。相關課程作業的提交內容不得重複。

唯讀。
userId

string

擁有這項作業的學生 ID。

唯讀。
creationTime

string (Timestamp format)

這項提交內容的建立時間。如果學生尚未存取這個項目，這項屬性可能不會設定。

唯讀。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

這項提交內容的上次更新時間。如果學生尚未存取這個項目，這項屬性可能不會設定。

唯讀。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
state

enum (SubmissionState)

這項提交內容的狀態。

唯讀。
late

boolean

作業是否遲交。

唯讀。
draftGrade

number

選填的待處理成績。如果未設定，表示未設定成績。這個值必須是非負數。允許使用小數 (即非整數) 值，但會四捨五入到小數點後兩位。

只有課程老師能看到並修改這項資訊。
assignedGrade

number

選填年級。如果未設定，表示未設定成績。這個值必須是非負數。允許使用小數 (即非整數) 值，但會四捨五入到小數點後兩位。

只有課程老師可以修改這項設定。
rubricId

string

僅供輸出。目前附加至這項課程作業，並用於評估學生提交內容的評分量表 ID。

如果沒有評量表，這個 ID 會留空。這個 ID 會反映目前有效的評量表；如果老師刪除並重新建立評量表，這個 ID 就會變更。

這個唯讀設定檔
draftRubricGrades

map (key: string, value: object (RubricGrade))

根據評分量表標準，待處理的評分量表成績。

如果課程作業未附上評分量表，或是附上評分量表，但未設定任何準則的分數，這張地圖就會空白。只有已設定的成績才會填入資料。鍵：評量表條件 ID。

唯讀。

這個物件中包含 "key": value 組合的清單，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
assignedRubricGrades

map (key: string, value: object (RubricGrade))

根據評分量表的「標準」指派評分量表成績。

如果課程作業未附上評分量表，或是附上評分量表，但未設定任何準則的分數，這張地圖就會空白。只有已設定的成績才會填入資料。鍵：評量表條件 ID。

唯讀。

這個物件中包含 "key": value 組合的清單，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
courseWorkType

enum (CourseWorkType)

這項提交內容所屬的課程作業類型。

唯讀。
associatedWithDeveloper

boolean

這個學生提交內容是否與發出要求的 Play 管理中心專案相關聯。

詳情請參閱 courseWork.create。

唯讀。
submissionHistory[]

object (SubmissionHistory)

提交記錄 (包括狀態和成績記錄)。

唯讀。
previewVersion

enum (PreviewVersion)

僅供輸出。API 的預覽版本。您必須設定這個值，才能存取開發人員預覽計畫中提供的新 API 功能。
聯集欄位 content。提交內容。具體類型取決於 course_work_type 的值。content 只能是下列其中一項：
assignmentSubmission

object (AssignmentSubmission)

當 courseWorkType 為 ASSIGNMENT 時，提交的內容。

學生可以使用 studentSubmissions.modifyAttachments 修改這項內容。
shortAnswerSubmission

object (ShortAnswerSubmission)

courseWorkType 為 SHORT_ANSWER_QUESTION 時的提交內容。
multipleChoiceSubmission

object (MultipleChoiceSubmission)

如果 courseWorkType 為 MULTIPLE_CHOICE_QUESTION，則為提交內容。

RubricGrade

為學生提交的作業設定評分量表成績。每個評分標準最多只能有一個項目。

JSON 表示法 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
欄位
criterionId

string

(選用步驟) 條件 ID。
levelId

string

(選用步驟) 選取層級的選填層級 ID。如果為空白，表示未選取任何層級。
points

number

(選用步驟) 這個準則可獲得的分數 (選填)，通常會根據等級而定。等級可能會有分數，也可能沒有。如果未設定，表示這項條件未設定任何分數。

AssignmentSubmission

作業的學生作業。

JSON 表示法 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
欄位
attachments[]

object (Attachment)

學生新增的附件。如果學生尚未在 Classroom 中存取作業，對應於共用模式為 STUDENT_COPY 的教材，雲端硬碟檔案可能還不存在。

只有在要求存取的使用者有權存取附件時，系統才會填入部分附件中繼資料。「identifier」和「alternateLink」欄位一律可用，但其他欄位 (例如「title」) 可能無法使用。

附件

已在學生作業中新增附件。

建立附件時，系統不支援設定 form 欄位。

JSON 表示法 
{

  // Union field attachment can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field attachment.
}
欄位
聯集欄位 attachment。附件資料。attachment 只能是下列其中一項：
driveFile

object (DriveFile)

附加 Google 雲端硬碟檔案。
youTubeVideo

object (YouTubeVideo)

YouTube 影片附件。
form

object (Form)

Google 表單附件。

ShortAnswerSubmission

簡答題的學生作業。

JSON 表示法 
{
  "answer": string
}
欄位
answer

string

學生對簡答題的回覆。

MultipleChoiceSubmission

選擇題的學生作業。

JSON 表示法 
{
  "answer": string
}
欄位
answer

string

學生選取的選項。

SubmissionHistory

提交記錄。目前包括州別和年級記錄。

JSON 表示法 
{

  // Union field type can be only one of the following:
  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
  // End of list of possible types for union field type.
}
欄位
聯集欄位 type。SubmissionHistory 的類型，可以是 StateHistory 或 GradeHistory。type 只能是下列其中一項：
stateHistory

object (StateHistory)

提交內容的狀態記錄資訊 (如有)。
gradeHistory

object (GradeHistory)

提交內容的成績記錄資訊 (如有)。

StateHistory

這項提交內容的每個狀態記錄。

JSON 表示法 
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
欄位
state

enum (State)

工作流程管道階段。
stateTimestamp

string (Timestamp format)

提交內容進入這個狀態的時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
actorUserId

string

進行變更的老師或學生。

州

提交內容可能處於的狀態。

列舉
STATE_UNSPECIFIED 未指定任何州別。這個值絕不應傳回。
CREATED 已建立提交內容。
TURNED_IN 學生已繳交指派的文件，該文件可能是範本。
RETURNED 老師已將指派的文件發還給學生。
RECLAIMED_BY_STUDENT 學生繳交指派的文件，然後選擇「取消繳交」作業，讓學生再次取得擁有者控制權。
STUDENT_EDITED_AFTER_TURN_IN 學生在繳交作業後編輯了提交內容。目前僅用於「問題」功能，學生編輯答案時會用到。

GradeHistory

這項提交內容的各項評分記錄。

JSON 表示法 
{
  "pointsEarned": number,
  "maxPoints": number,
  "gradeTimestamp": string,
  "actorUserId": string,
  "gradeChangeType": enum (GradeChangeType)
}
欄位
pointsEarned

number

提交作業時，成績記錄中的成績分子。
maxPoints

number

目前繳交作業成績記錄中的成績分母。
gradeTimestamp

string (Timestamp format)

提交內容的成績變更時。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
actorUserId

string

變更成績的老師。
gradeChangeType

enum (GradeChangeType)

作業繳交記錄中，此時的成績變更類型。

GradeChangeType

可能的成績變更類型。

列舉
UNKNOWN_GRADE_CHANGE_TYPE 未指定成績變更類型。這個值絕不應傳回。
DRAFT_GRADE_POINTS_EARNED_CHANGE 草稿成績的分數變更。
ASSIGNED_GRADE_POINTS_EARNED_CHANGE 指派成績的分數變更。
MAX_POINTS_CHANGE 成績分母的變化。

方法

get

 傳回學生的作業。

list

 傳回要求者有權查看的學生繳交作業清單，並考量要求中的 OAuth 範圍。

modifyAttachments

 修改學生繳交作業的附件。

patch

 更新學生提交內容的一或多個欄位。

reclaim

 代表擁有者學生收回學生提交的內容。

return

 傳回學生的作業。

turnIn

 繳回學生提交的作業。