이 문서에서는 Classroom API와 관련된 채점 개념을 소개합니다.
Google 클래스룸 앱에서 교사가 점수를 매기는 과정에 대해 알아보려면 과제 채점 및 추적 도움말을 참고하세요.
강의 과제 및 제출물
Google 클래스룸에서 학생은 Course의 CourseWork 과제에 대한 StudentSubmissions를 제출합니다. CourseWork는 채점되거나 채점되지 않을 수 있습니다. CourseWork가 채점된 경우 과제의 총점을 나타내는 maxPoints 값이 포함됩니다. maxPoints이 0이거나 지정되지 않은 경우 과제에 채점이 없습니다.
채점된 과제의 경우 교사는 과제를 학생에게 돌려주기 전에 StudentSubmission에서 draftGrade 성적을 설정합니다. 제출물이 클래스룸 앱에서 반환되면 assignedGrade가 StudentSubmission에 현재 draftGrade와 동일한 값으로 자동으로 설정됩니다. 개발자는 이 두 필드를 모두 설정할 수 있으며 클래스룸 앱의 동작을 에뮬레이션해야 합니다. 예를 들어 assignedGrade는 draftGrade 없이 설정할 수 없습니다. 두 필드 모두 소수점으로 표시되며, 설정되지 않은 경우 교사가 아직 해당 성적을 설정하지 않았음을 의미합니다.
성적을 읽고, 설정하고, 반환하는 코드 예시는 성적 만들기 및 관리를 참고하세요.
학생은 동일한 CourseWork 과제에 여러 개의 제출물을 제출할 수 있으며, 제출 상태와 성적 기록은 StudentSubmission.submissionHistory에서 추적됩니다.
기한이 지났거나, 변명할 수 있거나, 누락된 과제물
CourseWork 항목이 할당되면 학생이 해당 과제와 상호작용하지 않았더라도 각 학생에 대해 자리표시자 StudentSubmissions가 생성됩니다. 교사는 CourseWork에서 dueDate를 설정할 수 있으며, 학생이 날짜까지 과제를 제출하지 않으면 연결된 StudentSubmissions에 late 필드 (true로 설정됨)가 표시됩니다. 교사는 클래스룸 앱의 설정에서 늦은 제출을 사용 중지할 수도 있습니다.
또한 dueDate 전에 제출되지 않은 StudentSubmissions는 클래스룸 성적 기록에 누락됨으로 주석이 추가됩니다. 교사는 클래스룸 앱에서 제출물을 누락된 것으로 직접 표시할 수도 있습니다. 누락된 과제에는 자동으로 draftGrade가 부여되며, 이는 교사가 맞춤설정할 수 있지만 기본값은 0입니다.
누락된 제출물은 완료로 표시되거나 교사가 면제된 것으로 표시할 수 있습니다.
완료로 표시된 StudentSubmissions의 경우 교사가 새 draftGrade 필드를 수동으로 설정할 때까지 기본 draftGrade 필드가 삭제됩니다. 면제됨으로 표시된 StudentSubmissions는 채점 기간을 비롯한 전체 점수 계산에서 삭제됩니다.
교사가 제출물을 처리하는 방법을 자세히 알아보려면 과제 채점 및 반환 도움말을 참고하세요.
전체 성적 및 평가 시스템
클래스룸은 학생의 전체 성적을 계산하기 위해 여러 평가 시스템을 지원합니다. 전체 성적은 총점에서 직접 계산하거나, 카테고리별로 가중치를 적용하거나, 아예 계산하지 않을 수 있습니다.
채점 설정 도움말에서 다양한 채점 시스템과 예시를 알아보세요.
주요 사항은 다음과 같습니다.
Course리소스에는 과정 성적 설정에 관한 세부정보가 포함된gradebookSettings객체가 있습니다.calculationType는 과정의 계산 방법을 지정합니다.displaySettings는 클래스룸 앱에서 전체 성적을 볼 수 있는 사용자를 지정합니다. 가능하면 자체 애플리케이션에서 이를 따르는 것이 좋습니다. 예를 들어 학생이 클래스룸에서 전체 성적을 볼 수 없다면 앱에서 학생에게 전체 성적을 표시하지 마세요.gradeCategories에는 과정에 구성된 평가 카테고리 목록(표시 이름, 가중치 비율, 해당 과제의 기본 점수 포함)이 포함됩니다.
- 과정에서 가중치 평가를 사용하는 경우 카테고리가 없는 시나리오에서 가중치를 정규화해야 할 수 있습니다. 예를 들어 카테고리 가중치가 과제 20%, 연습문제 10%, 퀴즈 70% 였지만 실제로 연습문제가 없는 경우, 클래스룸은 전체 성적을 계산할 때 가중치를 과제의 경우 약 22%, 퀴즈의 경우 약 78%로 조정합니다. 애플리케이션에서 클래스룸 전체 성적을 미러링하려면 동일한 작업을 수행해야 합니다.
평가 기간
교사는 강의의 CourseWork 과제를 평가 기간이라는 고유한 기간으로 그룹화할 수 있습니다. 평가 기간은 성적 기록 보기에서 과정을 필터링하고 전체 성적 계산을 위한 고유한 버킷을 만드는 데 사용할 수 있습니다.
예를 들어 교사는 '봄'과 '가을' 학기 평가 기간을 만들 수 있습니다. 봄 기간의 전체 성적 점수에는 봄 기간에 제출해야 하는 StudentSubmissions만 포함됩니다.
과정에 설정된 평가 시스템은 평가 기간으로 확장됩니다. 따라서 앞서 언급한 봄과 가을 예의 평가 기간을 가중치 적용 평가 카테고리를 사용하는 과정에 설정한 경우 학생의 총 성적은 다음 세 가지 세트가 됩니다.
- 과정의 모든 과제에 대한 전체 성적입니다.
- 봄 기간의 모든 과제에 대한 전체 성적입니다.
- 가을 기간의 모든 과제에 대한 전체 성적입니다.
세 가지 모두 카테고리별 가중치를 적용하여 전체 성적을 계산합니다.
이 기능에 대한 개요는 평가 기간 공지사항을 참고하세요.
평가 기간은 과제가 속하는 평가 기간을 식별하는 gradingPeriodId로 CourseWork를 확장합니다.
API를 사용하여 평가 기간을 읽고 관리하는 방법은 평가 기간 API 가이드를 참조하세요.
기준표
교사는 Rubrics를 만들어 CourseWork 과제와 연결할 수 있으며, 해당하는 StudentSubmissions를 채점할 때 이러한 기준표를 가이드로 사용할 수 있습니다.
교사가 클래스룸에서 기준표를 사용하는 방법을 알아보려면 기준표 도움말을 참고하세요.
평가 기준은 추가 필드로 StudentSubmissions 리소스를 확장합니다.
rubricId는 제출물의CourseWork에 해당하는 평가 기준을 식별합니다.draftRubricGrades는 교사가 제출물을 학생에게 반환하기 전에 작성한 기준 및 자리표시자 점수를 나타냅니다.assignedRubricGrades는 교사가 제출물을 돌려준 후 학생이 받는 기준 및 점수를 나타냅니다.
API를 사용하여 루브릭을 관리하고 관련 성적을 읽는 방법은 rubrics API 가이드를 참고하세요.
평가 기준
클래스룸에서는 맞춤설정 가능한 평가 기준을 지원합니다. 예를 들어 교사는 숫자 성적을 문자로 된 성적으로 변환할 수 있습니다. 이러한 설정과 해당 데이터는 API에서 사용할 수 없습니다.