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

클래스룸 평가 기준에 익숙하지 않다면 고객센터 도움말에서 평가 기준의 일반적인 구조와 클래스룸 UI에서 평가 기준으로 채점하는 방법을 알아보세요.

기준표 구조

API를 사용하여 루브릭과 상호작용할 때 강조할 만한 몇 가지 중요한 개념이 있습니다.

  • CourseWork와 연결된 기준은 최대 1개이며 이 기준은 해당 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 Sheets로 내보낼 수 있습니다.

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

이전
평가 기간