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

과정의 식별자입니다.

읽기 전용입니다.
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

대기 중인 성적(선택사항)입니다. 설정하지 않으면 성적이 설정되지 않습니다. 이 값은 음수가 아니어야 합니다. 소수점 이하, 즉 정수가 아닌 값을 사용할 수 있지만 소수점 이하 두 자리로 반올림됩니다.

이는 코스 교사만 볼 수 있고 수정할 수 있습니다.
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

학생 제출물이 요청하는 개발자 콘솔 프로젝트와 연결되어 있는지 여부

자세한 내용은 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 파일이 아직 존재하지 않을 수 있습니다.

일부 첨부파일 메타데이터는 요청하는 사용자에게 액세스 권한이 있는 경우에만 채워집니다. 식별자 및 대체 링크 필드는 항상 제공되지만, 다른 필드 (예: 제목)는 제공되지 않을 수 있습니다.

첨부파일

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

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

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