성적

이 문서에서는 Classroom API와 관련된 등급 개념을 소개합니다.

Google 클래스룸 앱의 교사 채점 여정에 대해 알아보려면 점수 부여 및 과제 추적 도움말을 참고하세요.

CourseWork 및 StudentSubmissions

Google 클래스룸에서 학생은 Course의 CourseWork 과제에 대해 StudentSubmissions를 제출합니다. CourseWork은 등급이 매겨지거나 등급이 매겨지지 않을 수 있습니다. CourseWork에 등급이 매겨진 경우 과제의 총점을 나타내는 maxPoints 값이 있습니다. maxPoints이 0이거나 지정되지 않은 경우 과제는 미채점 상태입니다.

성적이 부여되는 과제의 경우 교사는 학생에게 돌려주기 전에 StudentSubmission에서 draftGrade 성적을 설정합니다. 클래스룸 앱에서 제출이 반환되면 현재 draftGrade와 동일한 값으로 StudentSubmission에 assignedGrade가 자동으로 설정됩니다. 개발자는 이 두 필드를 모두 설정할 수 있으며 클래스룸 앱의 동작을 에뮬레이션해야 합니다. 예를 들어 draftGrade 없이 assignedGrade를 설정할 수 없습니다. 두 필드는 모두 10진수로 표시되며, 설정되지 않은 경우 교사가 아직 해당 성적을 설정하지 않았음을 의미합니다. 성적을 읽고 설정하고 반환하는 코드 예시는 성적 만들기 및 관리를 참고하세요.

학생은 동일한 CourseWork 과제에 여러 제출물을 제출할 수 있으며 제출 상태와 성적 기록은 StudentSubmission.submissionHistory에서 추적됩니다.

지각, 면제, 누락된 수업

CourseWork 항목이 할당되면 학생이 해당 과제와 상호작용한 적이 없더라도 각 학생에 대해 자리표시자 StudentSubmissions가 생성됩니다. 교사는 CourseWork에 dueDate를 설정할 수 있으며, 학생이 날짜 전에 과제를 제출하지 않으면 연결된 StudentSubmissions에 late 필드 (true로 설정)가 표시됩니다. 교사는 클래스룸 앱의 설정을 사용하여 지각 제출을 사용 중지할 수도 있습니다.

또한 dueDate 전에 제출되지 않은 StudentSubmissions는 클래스룸 성적 기록에 누락으로 표시됩니다. 교사는 클래스룸 앱에서 제출물을 누락으로 수동 표시할 수도 있습니다. 누락된 과제에는 자동으로 draftGrade가 부여되며, 이는 교사가 맞춤설정할 수 있지만 기본값은 0입니다.

누락된 제출물은 교사가 완료됨 또는 면제됨으로 표시할 수 있습니다. StudentSubmissions가 완료로 표시된 경우 교사가 새 draftGrade 필드를 수동으로 설정할 때까지 기본 draftGrade 필드가 삭제됩니다. StudentSubmissions로 표시된 과제는 성적 기간을 비롯한 전체 점수 계산에서 삭제됩니다.

교사가 제출물을 처리하는 방법을 자세히 알아보려면 과제 채점 및 반환 도움말을 참고하세요.

전체 성적 및 평가 시스템

클래스룸에서는 학생의 전체 성적을 계산하기 위한 여러 성적 시스템을 지원합니다. 전체 성적은 총점, 카테고리별 가중치에서 직접 계산하거나 전혀 계산하지 않을 수 있습니다.

성적 설정 도움말에서 다양한 성적 시스템을 예와 함께 알아보세요.

몇 가지 주요 사항은 다음과 같습니다.

Course 리소스에는 과정 성적 설정에 관한 세부정보가 있는 gradebookSettings 객체가 있습니다.
- calculationType는 강의의 계산 방법을 지정합니다.
- displaySettings는 Classroom 앱에서 전체 성적을 볼 수 있는 사용자를 지정합니다. 가능하면 자체 애플리케이션에서 이를 준수하는 것이 좋습니다. 예를 들어 학생이 클래스룸에서 전체 성적을 볼 수 없는 경우 앱에서 전체 성적을 표시하지 마세요.
- gradeCategories에는 표시 이름, 가중치 비율, 해당 과제의 기본 점수를 비롯하여 강의에 구성된 평가 카테고리 목록이 포함됩니다.
강의에서 가중치 평가를 사용하는 경우 카테고리가 없는 시나리오에서 가중치를 정규화해야 할 수 있습니다. 예를 들어 카테고리 가중치가 과제 20%, 연습 문제 10%, 퀴즈 70% 이지만 실제로 연습 문제가 없는 경우 Classroom에서는 전체 성적을 계산할 때 가중치를 과제 ~22%, 퀴즈 ~78%로 조정합니다. 애플리케이션에서 클래스룸 전체 성적을 미러링하려면 동일한 작업을 수행해야 합니다.

평가 기간

교사는 CourseWork수업의 과제를 평가 기간이라는 별도의 기간으로 그룹화할 수 있습니다. 평가 기간을 사용하여 성적 기록 보기에서 학습 활동을 필터링하고 전체 성적 계산을 위한 별도의 버킷을 만들 수 있습니다.

예를 들어 교사는 '봄' 및 '가을' 학기 성적 기간을 만들 수 있습니다. 봄 기간의 전체 성적 점수에는 봄 기간에 제출되는 StudentSubmissions만 포함됩니다.

수업에 설정된 평가 시스템은 평가 기간까지 적용됩니다. 따라서 가중치 부여 성적 카테고리를 사용하는 과정에 앞서 언급한 봄과 가을 예시 성적 기간이 설정된 경우 학생에게는 궁극적으로 다음과 같은 세 가지 전체 성적이 표시됩니다.

수업의 모든 과제의 전체 성적입니다.
봄 기간의 모든 과제에 대한 전체 성적입니다.
가을 기간의 모든 과제에 대한 전체 성적입니다.

세 가지 모두 가중치가 적용된 카테고리를 사용하여 전체 성적을 계산합니다.

이 기능의 개요는 평가 기간 공지사항을 참고하세요.

평가 기간은 과제가 속한 평가 기간을 식별하는 gradingPeriodId로 CourseWork를 확장합니다.

평가 기간 API 가이드를 참고하여 API로 평가 기간을 읽고 관리하는 방법을 알아보세요.

기준표

교사는 Rubrics를 만들어 CourseWork 과제와 연결하고, 해당 StudentSubmissions를 채점할 때 이 기준표를 가이드로 사용할 수 있습니다.

교사가 클래스룸에서 기준표를 사용하는 방법을 알아보려면 기준표 도움말을 참고하세요.

평가 기준은 추가 필드를 사용하여 StudentSubmissions 리소스를 확장합니다.

rubricId는 제출의 CourseWork에 해당하는 루브릭을 식별합니다.
draftRubricGrades은 교사가 학생에게 제출물을 돌려주기 전에 작성한 기준과 자리표시자 점수를 나타냅니다.
assignedRubricGrades는 교사가 제출물을 돌려준 후 학생이 받는 기준과 점수를 나타냅니다.

API로 루브릭을 관리하고 관련 성적을 읽는 방법은 루브릭 API 가이드를 참고하세요.

평가 기준

클래스룸에서는 맞춤설정 가능한 평가 기준을 지원합니다. 예를 들어 교사가 숫자 등급을 문자 등급으로 변환할 수 있습니다. 이러한 설정과 해당 데이터는 API에서 사용할 수 없습니다.

API 리소스

사용자 유형