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)

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

읽기 전용입니다.

생성된 출력은 항상 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

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

자세한 내용은 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)

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

일부 첨부파일 메타데이터는 요청하는 사용자에게 액세스 권한이 있는 경우에만 채워집니다. 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 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. 제출 기록의 유형입니다. 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)

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

생성된 출력은 항상 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

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