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),

  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
}
필드
courseId

string

수업의 식별자입니다.

읽기 전용입니다.
courseWorkId

string

이 항목이 해당하는 수업 과제의 식별자입니다.

읽기 전용입니다.
id

string

학생 제출물에 대해 클래스룸에서 할당한 식별자입니다. 관련 과제물의 제출물 중에서 고유합니다.

읽기 전용입니다.
userId

string

이 제출물을 소유한 학생의 식별자입니다.

읽기 전용입니다.
creationTime

string (Timestamp format)

이 제출물의 생성 시간입니다. 학생이 이 항목에 액세스하지 않은 경우 설정되지 않을 수 있습니다.

읽기 전용입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

이 제출의 마지막 업데이트 시간입니다. 학생이 이 항목에 액세스하지 않은 경우 설정되지 않을 수 있습니다.

읽기 전용입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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는 현재 활성 상태인 기준표를 반영하며, 교사가 기준표를 삭제하고 다시 만들면 변경됩니다.

읽기 전용입니다.

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

이 학생 제출물이 요청을 수행하는 Developer Console 프로젝트와 연결되어 있는지 여부입니다.

자세한 내용은 courseWork.create를 참고하세요.

읽기 전용입니다.
submissionHistory[]

object (SubmissionHistory)

제출물 기록 (상태 및 성적 기록 포함)입니다.

읽기 전용입니다.
previewVersion

enum (PreviewVersion)

출력 전용입니다. API의 프리뷰 버전입니다. 미리보기 프로그램에서 개발자에게 제공되는 새로운 API 기능에 액세스하려면 이 값을 설정해야 합니다.
제출 콘텐츠 구체적인 유형은 course_work_type 값에 따라 달라집니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
assignmentSubmission

object (AssignmentSubmission)

courseWorkType이 ASSIGNMENT인 경우 제출 콘텐츠입니다.

학생은 studentSubmissions.modifyAttachments을(를) 사용하여 이 콘텐츠를 수정할 수 있습니다.
shortAnswerSubmission

object (ShortAnswerSubmission)

courseWorkType이 SHORT_ANSWER_QUESTION인 경우 제출 콘텐츠입니다.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

courseWorkType이 MULTIPLE_CHOICE_QUESTION인 경우 제출 콘텐츠입니다.
상호 배타적 필드의 끝입니다.

RubricGrade

학생 제출물에 설정된 기준표 성적입니다. 기준표 기준당 항목은 최대 1개입니다.

JSON 표현 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
필드
criterionId

string

선택사항입니다. 기준 ID입니다.
levelId

string

선택사항입니다. 선택한 레벨의 선택적 레벨 ID입니다. 비어 있으면 수준이 선택되지 않은 것입니다.
points

number

선택사항입니다. 이 기준에 할당된 선택적 점수이며 일반적으로 수준에 따라 다릅니다. 등급에 포인트가 있을 수도 있고 없을 수도 있습니다. 설정하지 않으면 이 기준에 점수가 설정되지 않습니다.

AssignmentSubmission

과제에 대한 학생 과제물입니다.

JSON 표현 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
필드
attachments[]

object (Attachment)

학생이 추가한 첨부파일 학생이 클래스룸에서 과제에 액세스하지 않은 경우 공유 모드가 STUDENT_COPY인 자료에 해당하는 Drive 파일이 아직 존재하지 않을 수 있습니다.

일부 첨부파일 메타데이터는 요청하는 사용자에게 액세스 권한이 있는 경우에만 채워집니다. identifier 및 alternateLink 필드는 항상 사용할 수 있지만 다른 필드 (예: title)는 사용할 수 없을 수도 있습니다.

첨부파일

학생 과제물에 첨부파일이 추가되었습니다.

첨부파일을 만들 때 form 필드 설정은 지원되지 않습니다.

JSON 표현 
{

  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
}
필드
첨부파일 데이터입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
driveFile

object (DriveFile)

Google Drive 파일 첨부
youTubeVideo

object (YouTubeVideo)

YouTube 동영상 첨부파일
form

object (Form)

Google Forms 첨부파일
상호 배타적 필드의 끝입니다.

ShortAnswerSubmission

단답형 질문에 대한 학생 과제물

JSON 표현 
{
  "answer": string
}
필드
answer

string

단답형 질문에 대한 학생의 답변입니다.

MultipleChoiceSubmission

객관식 질문에 대한 학생 과제

JSON 표현 
{
  "answer": string
}
필드
answer

string

학생이 선택한 항목입니다.

SubmissionHistory

제출 기록입니다. 여기에는 현재 상태 및 등급 기록이 포함됩니다.

JSON 표현 
{

  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
}
필드
SubmissionHistory의 유형으로, StateHistory, GradeHistory 중 하나일 수 있습니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
stateHistory

object (StateHistory)

제출물의 상태 기록 정보입니다(있는 경우).
gradeHistory

object (GradeHistory)

제출물의 성적 기록 정보입니다(있는 경우).
상호 배타적 필드의 끝입니다.

StateHistory

이 제출물이 거친 각 상태의 기록입니다.

JSON 표현 
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
필드
state

enum (State)

워크플로 파이프라인 단계입니다.
stateTimestamp

string (Timestamp format)

제출이 이 상태로 전환된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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)

제출물의 성적이 변경된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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

 학생 제출물을 제출합니다.