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

이 학생 제출물이 요청하는 Play 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인 자료에 해당하는 드라이브 파일이 아직 존재하지 않는 것일 수 있습니다.

일부 첨부파일 메타데이터는 요청하는 사용자에게 액세스 권한이 있는 경우에만 채워집니다. 식별자 및 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

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