REST Resource: courses.courseWork.studentSubmissions

리소스: StudentSubmission

학생이 강의 과제를 제출한 경우

StudentSubmission 항목은 CourseWork 항목이 생성될 때 생성됩니다.

액세스한 적이 없는 학생 제출물 (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

과정의 식별자입니다.

읽기 전용입니다.
courseWorkId

string

이에 상응하는 과정 과제의 식별자입니다.

읽기 전용입니다.
id

string

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

읽기 전용입니다.
userId

string

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

읽기 전용입니다.
creationTime

string (Timestamp format)

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

읽기 전용입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
updateTime

string (Timestamp format)

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

읽기 전용입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
state

enum (SubmissionState)

이 제출의 상태입니다.

읽기 전용입니다.
late

boolean

제출 기한이 지났는지 여부입니다.

읽기 전용입니다.
draftGrade

number

선택사항인 대기 중인 성적입니다. 설정되지 않은 경우 성적이 설정되지 않은 것입니다. 이 값은 음수가 아니어야 합니다. 소수점 (즉, 정수가 아닌) 값은 허용되지만 소수점 이하 2자리로 반올림됩니다.

이 내용은 과정 교사에게만 표시되며 교사만 수정할 수 있습니다.
assignedGrade

number

선택사항인 성적입니다. 설정되지 않은 경우 성적이 설정되지 않은 것입니다. 이 값은 음수가 아니어야 합니다. 소수점 (즉, 정수가 아닌) 값은 허용되지만 소수점 이하 2자리로 반올림됩니다.

과정 교사만 수정할 수 있습니다.
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 기능에 액세스하려면 이 값을 설정해야 합니다.
통합 필드 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

학생 제출물에 대해 설정된 루브릭 성적입니다. 기준표 기준당 항목은 최대 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 파일이 아직 존재하지 않을 수 있습니다.

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

첨부파일

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

첨부파일을 만들 때 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 Drive 파일 첨부
youTubeVideo

object (YouTubeVideo)

YouTube 동영상 첨부파일
form

object (Form)

Google Forms 첨부파일

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 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "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 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "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

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