기준표 구조 및 알려진 제한사항

클래스룸 기준표에 익숙하지 않은 경우 다음 고객센터 도움말을 참고하여 기준표의 일반적인 구조와 클래스룸 UI에서 기준표 채점이 이루어지는 방식을 알아보세요.

기준표 구조

API를 사용하여 기준표와 상호작용할 때 강조할 만한 몇 가지 중요한 개념이 있습니다.

  • `CourseWork`와 연결된 기준표는 최대 1개이며, 이 기준표는 해당 `CourseWork`에 고유합니다( `CourseWork` 리소스 간에 공유할 수 없음).
  • 기준표는 등급으로 구성된 기준으로 구성됩니다. 기준표에는 항상 기준이 하나 이상 있어야 하며, 기준에는 항상 등급이 하나 이상 있어야 합니다.
  • 등급은 점수가 있거나 (점수 부여) 점수가 없을 수 있습니다 (점수 없음). 기준표에서 등급은 모두 점수가 있거나 모두 점수가 없어야 합니다.
    • 등급에 점수가 있는 경우 기준의 모든 등급에 고유한 점수 값이 설정되어 있어야 합니다. 점수는 정수 (예: 10) 또는 부동 소수점 값 (예: 9.99)일 수 있습니다. 0을 포함할 수 있습니다. null 값은 허용되지 않습니다. 또한 기준표에는 등급이 하나이고 점수가 0점인 기준이 하나만 있을 수 없습니다.
    • 등급에 점수가 없는 경우 points 필드를 생략해야 합니다. null 값은 허용되지 않습니다.
  • 기준 및 등급의 순서는 의미가 있으며 클래스룸 UI에 표시되는 순서를 반영합니다.
    • 특히 점수가 있는 등급은 항상 점수를 기준으로 오름차순 또는 내림차순으로 정렬해야 합니다.
  • 기준표당 최대 50개의 기준과 기준당 최대 10개의 성취도 등급을 만들 수 있습니다.

StudentSubmission 객체는 기준표 관련 필드를 지원합니다.

  • 기존 draftGrade 및 assignedGrade 속성 외에도 기준표로 채점된 학생 제출물에는 draftRubricGrades 및 assignedRubricGrades 속성이 있습니다. 이는 각각 초안 및 할당된 상태에서 기준표를 사용하여 채점하는 동안 학생이 받는 기준표 등급 (선택된 등급 및 점수 값)을 나타냅니다.
  • 현재 이러한 속성은 읽기 전용입니다. 즉, API를 사용하여 제출물을 채점할 수는 없지만 클래스룸 UI에서 채점된 제출물을 읽을 수 있습니다.

기준표 동작

API는 일관성을 위해 가능한 한 클래스룸 UI를 미러링하는 것을 목표로 하지만, 이로 인해 개발자에게 직관적이지 않을 수 있는 동작이 발생할 수 있으므로 언급할 가치가 있습니다.

  • 기준표는 교사를 제한하지 않고 채점을 안내 하기 위한 것입니다. 따라서 교사는 기준표로 제출물을 채점할 때 다음 작업을 할 수 있습니다.
    • 채점 시 기준표를 완전히 무시합니다.
    • 기준의 등급에서 사용할 수 있는 점수와 관계없이 기준의 점수를 재정의합니다.
    • 기준의 하위 집합에 대해서만 등급을 선택합니다.
    • 해당 등급을 선택하지 않고 기준에 점수를 할당합니다.
    • 기준표에서 얻을 수 있는 점수와 관계없이 과제의 총점을 재정의합니다.

또한 API는 클래스룸 UI에 아직 없는 동작을 지원하지 않습니다. 예를 들어 API는 과제에 기준표 사용을 적용하거나 교사가 현재와 같이 기준표와 제출물을 수정할 수 있는 기능을 재정의할 수 없습니다.

채점 중 제한사항

마찬가지로 교사가 기준표로 채점을 시작한 후에는 기준표 수정에 몇 가지 추가 제한사항이 적용됩니다. 채점이 시작된 후에는 다음 수정만 가능합니다.

  • 기준 및 등급 제목과 설명에 텍스트 수정이 허용됩니다.
  • 기준 내에서 등급 순서를 변경할 수 있습니다.

추가 범위

기준표는 교사가 재사용할 수 있도록 Google Sheets로 수동으로 내보낼 수 있습니다.

이 스프레드시트에서 기준표를 만들거나 업데이트하는 경우 (가이드의 예 참고) 애플리케이션에서 https://www.googleapis.com/auth/spreadsheets.readonly 또는 https://www.googleapis.com/auth/spreadsheets 범위를 요청해야 합니다. spreadsheets 범위는 민감한 것으로 간주되며 애플리케이션 을 인증해야 할 수 있습니다.

서드 파티 학습 과제

기준표는 상위 CourseWork 항목을 만든 Google Cloud 프로젝트에서만 만들 수 있습니다. 이는 클래스룸 API의 더 광범위한 디자인 패턴으로, 서로 다른 애플리케이션이 자신의 리소스가 아닌 리소스에 영향을 미치지 못하도록 합니다.

이는 클래스룸 앱에서 사용자가 만든 리소스로 확장됩니다. 예를 들어 동일한 교사가 애플리케이션을 소유하고 있더라도 애플리케이션에서 교사가 클래스룸 UI에서 만든 학습 과제의 기준표를 관리할 수는 없습니다. 이로 인해 사용 사례가 크게 제한되는 경우 공개 Issue Tracker에서 의견을 공유하세요.

라이선스 요건

사용자는 다음 조건을 충족하는 경우에만 클래스룸 API로 기준표를 만들고, 업데이트하고, 삭제할 수 있습니다.

API 기능이 사용자에게 노출되는 방식에 관해 자세히 알아보려면 사용자 자격 요건을 참고하고, 개발용 데모 계정을 숙지하고 요청하려면 클래스룸 API 기본 요건을 참고하세요.

이전
평가 기간