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

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

기준표 구조

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

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

학생 제출물 객체도 변경됩니다.

  • 기준표로 채점된 학생 제출물에는 기존 draftGrade 및 assignedGrade 속성 외에도 draftRubricGrades 및 assignedRubricGrades 속성이 있습니다. 이는 각각 기준표, 초안 및 할당된 상태로 채점하는 동안 학생이 받는 기준표 성적 (선택된 수준 및 점수)을 나타냅니다.
  • 현재 이 속성은 읽기 전용입니다. 즉, API를 사용하여 제출물을 채점할 수는 없지만 클래스룸 UI에서 채점된 제출물은 읽을 수 있습니다.
  • 연결된 기준표가 있는 학생 제출물에는 rubricId 필드가 포함됩니다. 이 필드는 CourseWork와 연결된 최신 기준표를 나타내며 교사가 기준표를 삭제하고 다시 만들면 이 값이 변경될 수 있습니다.

기준표 동작

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

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

또한 이 API에는 새로운 제품 기능이 도입되지 않습니다. 즉, 클래스룸 UI에 아직 없는 동작을 API는 지원하지 않습니다. 예를 들어 API에서는 과제에 기준표를 시행하거나 교사가 기준표 및 제출물을 수정할 수 있는 기능을 현재처럼 재정의할 수 없습니다.

채점 시 제한사항

마찬가지로 교사가 채점을 시작한 후 기준표를 수정할 때도 몇 가지 추가 제한사항이 적용됩니다. 시작된 상태로 채점한 후에는 다음 수정사항만 수행할 수 있습니다.

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

추가 범위

기준표는 교사가 재사용할 수 있도록 수동으로 Google 스프레드시트로 내보낼 수 있습니다.

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