- 리소스: StudentSubmission
- RubricGrade
- AssignmentSubmission
- 첨부파일
- ShortAnswerSubmission
- MultipleChoiceSubmission
- SubmissionHistory
- StateHistory
- 상태
- GradeHistory
- GradeChangeType
- 메서드
리소스: StudentSubmission
학생이 수업 과제를 제출한 경우
CourseWork
항목을 만들면 StudentSubmission
항목이 생성됩니다.
액세스한 적이 없는 학생 제출물 (즉, state
= NEW 사용)에는 생성 시간이나 업데이트 시간이 없을 수 있습니다.
JSON 표현 |
---|
{ "courseId": string, "courseWorkId": string, "id": string, "userId": string, "creationTime": string, "updateTime": string, "state": enum ( |
필드 | |
---|---|
courseId |
과정의 식별자입니다. 읽기 전용입니다. |
courseWorkId |
여기에 해당하는 과정 과제물의 식별자입니다. 읽기 전용입니다. |
id |
클래스룸에서 할당한 학생 제출물의 식별자입니다. 이는 관련 학습과정 과제물 중에서 고유한 항목입니다. 읽기 전용입니다. |
userId |
제출물을 소유한 학생의 식별자입니다. 읽기 전용입니다. |
creationTime |
제출의 생성 시간입니다. 학생이 이 항목에 액세스하지 않은 경우 설정이 해제될 수 있습니다. 읽기 전용입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
updateTime |
제출의 최종 업데이트 시간입니다. 학생이 이 항목에 액세스하지 않은 경우 설정이 해제될 수 있습니다. 읽기 전용입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
state |
제출 상태입니다. 읽기 전용입니다. |
late |
제출 기한이 지났는지 여부입니다. 읽기 전용입니다. |
draftGrade |
대기 중인 성적입니다(선택사항). 설정하지 않으면 성적이 설정되지 않은 것입니다. 이 값은 음수가 아니어야 합니다. 십진수 (정수가 아님) 값이 허용되지만 소수점 이하 두 자리로 반올림됩니다. 이 정보는 과정 교사만 보고 수정할 수 있습니다. |
assignedGrade |
성적입니다(선택사항). 설정하지 않으면 성적이 설정되지 않은 것입니다. 이 값은 음수가 아니어야 합니다. 십진수 (정수가 아님) 값이 허용되지만 소수점 이하 두 자리로 반올림됩니다. 이 정보는 과정 교사만 수정할 수 있습니다. |
rubricId |
출력 전용. 현재 이 과정 과제에 연결되어 있으며 학생이 제출한 과제를 채점하는 데 사용되는 기준표의 식별자입니다. 기준표가 없는 경우 이 ID는 비어 있습니다. 이 ID는 현재 활성화된 기준표를 나타내며, 교사가 기준표를 삭제하고 다시 만들면 변경됩니다. 읽기 전용입니다. |
draftRubricGrades |
기준표 기준에 따라 대기 중인 기준표 성적입니다. 이 과정 과제에 첨부된 기준표가 없거나 기준표가 첨부되어 있지만 어떤 기준에도 성적이 설정되지 않은 경우 이 지도는 비어 있습니다. 항목은 설정된 성적에 대해서만 채워집니다. 키: 기준표의 기준 ID입니다. 읽기 전용입니다.
|
assignedRubricGrades |
기준표의 기준에 따라 할당된 기준표 성적입니다. 이 과정 과제에 첨부된 기준표가 없거나 기준표가 첨부되어 있지만 기준에 대해 성적이 설정되지 않은 경우 이 지도는 비어 있습니다. 항목은 설정된 성적에 대해서만 채워집니다. 키: 기준표의 기준 ID입니다. 읽기 전용입니다.
|
alternateLink |
클래스룸 웹 UI의 제출물로 연결되는 절대 링크입니다. 읽기 전용입니다. |
courseWorkType |
이 제출 과제의 유형입니다. 읽기 전용입니다. |
associatedWithDeveloper |
이 학생 제출물이 요청하는 Play Console 프로젝트와 연결되어 있는지 여부입니다. 자세한 내용은 읽기 전용입니다. |
submissionHistory[] |
제출 기록입니다 (상태 및 성적 기록 포함). 읽기 전용입니다. |
previewVersion |
출력 전용. API의 미리보기 버전입니다. 미리보기 프로그램에서 개발자에게 제공되는 새로운 API 기능에 액세스하려면 이를 설정해야 합니다. |
통합 필드 content . 콘텐츠 제출 구체적인 유형은 course_work_type 의 값에 따라 다릅니다. content 은 다음 중 하나여야 합니다. |
|
assignmentSubmission |
CourseWorkType이 ASSIGNMENT인 경우 콘텐츠를 제출합니다. 학생은 |
shortAnswerSubmission |
CourseWorkType이 SHORT_ANSWER_QUESTION일 때 콘텐츠를 제출합니다. |
multipleChoiceSubmission |
CourseWorkType이 MULTIPLE_CHOICE_QUESTION일 때 콘텐츠를 제출합니다. |
RubricGrade
학생 제출물에 설정된 기준표 성적입니다. 기준표 기준당 최대 1개의 항목이 허용됩니다.
JSON 표현 |
---|
{ "criterionId": string, "levelId": string, "points": number } |
필드 | |
---|---|
criterionId |
선택사항입니다. 기준 ID |
levelId |
선택사항입니다. 선택한 층의 레벨 ID입니다(선택사항). 비어 있으면 레벨이 선택되지 않은 것입니다. |
points |
선택사항입니다. 일반적으로 등급을 기준으로 이 기준에 할당되는 선택적 포인트입니다. 레벨에 포인트가 있을 수도 있고 없을 수도 있습니다. 설정하지 않으면 이 기준에 설정된 점수가 없습니다. |
AssignmentSubmission
과제에 대한 학생 과제물입니다.
JSON 표현 |
---|
{
"attachments": [
{
object ( |
필드 | |
---|---|
attachments[] |
학생이 추가한 첨부파일입니다. 학생이 클래스룸에서 과제에 액세스하지 않았다면 공유 모드가 STUDENT_COPY인 자료에 해당하는 드라이브 파일이 아직 존재하지 않는 것일 수 있습니다. 일부 첨부파일 메타데이터는 요청하는 사용자에게 액세스 권한이 있는 경우에만 채워집니다. 식별자 및 alternateLink 필드는 항상 사용할 수 있지만, 그 외의 다른 필드 (예: 제목)는 사용할 수 없습니다. |
애착
학생 과제 과제에 첨부파일이 추가되었습니다.
연결을 만들 때는 form
필드 설정이 지원되지 않습니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 attachment . 첨부파일 데이터입니다. attachment 은 다음 중 하나여야 합니다. |
|
driveFile |
Google Drive 첨부파일 |
youTubeVideo |
YouTube 동영상 첨부파일 |
link |
링크 첨부파일입니다. |
form |
Google Forms 첨부파일입니다. |
ShortAnswerSubmission
단답형 질문에 대한 학생 과제물입니다.
JSON 표현 |
---|
{ "answer": string } |
필드 | |
---|---|
answer |
단답형 질문에 대한 학생의 답변 |
MultipleChoiceSubmission
객관식 문제를 위한 학생 과제물입니다.
JSON 표현 |
---|
{ "answer": string } |
필드 | |
---|---|
answer |
학생이 직접 선택하는 옵션입니다. |
SubmissionHistory
제출 기록입니다. 현재 주 및 성적 기록이 포함됩니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 type . SubmissionHistory 유형은 StateHistory, GradeHistory 중 하나일 수 있습니다. type 은 다음 중 하나여야 합니다. |
|
stateHistory |
제출의 상태 기록 정보입니다(있는 경우). |
gradeHistory |
제출물의 성적 기록 정보입니다(있는 경우). |
StateHistory
제출이 이루어진 각 상태의 기록입니다.
JSON 표현 |
---|
{
"state": enum ( |
필드 | |
---|---|
state |
워크플로 파이프라인 단계입니다. |
stateTimestamp |
제출이 이 상태에 진입한 시점입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
actorUserId |
변경한 교사 또는 학생입니다. |
상태
제출이 가능한 상태입니다.
열거형 | |
---|---|
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 ( |
필드 | |
---|---|
pointsEarned |
제출 성적 기록에서 현재 성적의 분자입니다. |
maxPoints |
제출 성적 기록에서 표시되는 현재 성적의 분모입니다. |
gradeTimestamp |
제출물 성적이 변경된 시점 RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
actorUserId |
성적을 변경한 교사 |
gradeChangeType |
제출된 성적 기록에서 현재 변경되는 성적 유형입니다. |
GradeChangeType
가능한 성적 변경 유형입니다.
열거형 | |
---|---|
UNKNOWN_GRADE_CHANGE_TYPE |
지정된 성적 변경 유형이 없습니다. 이 값은 반환되지 않습니다. |
DRAFT_GRADE_POINTS_EARNED_CHANGE |
임시 성적의 분자 변경입니다. |
ASSIGNED_GRADE_POINTS_EARNED_CHANGE |
할당된 성적의 분자 변경입니다. |
MAX_POINTS_CHANGE |
성적의 분모 변경입니다. |
방법 |
|
---|---|
|
학생 제출물을 반환합니다. |
|
요청의 OAuth 범위를 고려하여 요청자가 볼 수 있는 학생 제출물 목록을 반환합니다. |
|
학생 제출물의 첨부파일을 수정합니다. |
|
학생 제출물에서 하나 이상의 입력란을 업데이트합니다. |
|
소유한 학생을 대신하여 학생 제출물을 복원합니다. |
|
학생 제출물을 반환합니다. |
|
학생 제출물을 제출합니다. |