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

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

기준표 구조

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

  • CourseWork와 연결된 기준은 최대 1개이며 이 기준은 해당 CourseWork에 고유합니다(CourseWork 리소스 간에 공유할 수 없음).
  • 평가 기준은 수준으로 구성된 기준으로 구성됩니다. 기준에는 항상 기준이 하나 이상 있어야 하며 기준에는 항상 등급이 하나 이상 있어야 합니다.
  • 점수가 있는 레벨 (포인트 있음)과 점수가 없는 레벨 (포인트 없음)이 있습니다. 평가 기준에서 수준에 점수를 전부 부여하거나 전혀 부여하지 않아야 합니다.
    • 수준에 점수가 부여되는 경우 기준의 모든 수준에 고유한 점수 값이 설정되어야 합니다. 점은 정수 (예: 10) 또는 부동 소수점 값 (예: 9.99)일 수 있습니다. 여기에는 0이 포함될 수 있습니다. null 값은 허용되지 않습니다. 또한 루브릭에는 점수가 0인 단일 수준의 단일 기준을 포함할 수 없습니다.
    • 점수가 없는 수준인 경우 점수 필드는 생략해야 합니다. 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 프로젝트에서만 만들 수 있습니다. 이는 Classroom API의 더 광범위한 디자인 패턴으로, 다른 애플리케이션이 본인이 소유하지 않은 리소스에 영향을 미치지 못하도록 합니다.

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

라이선스 요건

사용자는 다음 조건이 충족되는 경우에만 Classroom API를 사용하여 루브릭을 생성, 업데이트, 삭제할 수 있습니다.

API 기능이 사용자에게 노출되는 방식과 개발을 위한 데모 계정을 숙지하고 요청하는 데 필요한 Classroom API 요구사항에 관해 자세히 알아보려면 사용자 자격 요건을 참고하세요.

이전
평가 기간