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)

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

唯讀。

RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如 "2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateTime

string (Timestamp format)

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

唯讀。

RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如 "2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
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

這份學生提交內容是否與提出要求的開發人員工作台專案相關聯。

詳情請參閱 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 的相關教材對應的雲端硬碟檔案可能尚未建立。

只有在要求使用者有權存取附件中繼資料時，系統才會填入部分附件中繼資料。系統一律會提供 ID 和 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)

提交內容進入此狀態時。

RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如 "2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
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)

繳交作業的成績有變更。

RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如 "2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
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

 繳交學生作業。