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

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

기준표 구조

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

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

StudentSubmission 객체는 루브릭 관련 필드를 지원합니다.

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

기준표 동작

API는 일관성을 위해 가능한 한 Classroom 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에서 교사가 만든 과제에 대한 루브릭을 관리할 수는 없습니다. 이로 인해 사용 사례가 크게 제한되는 경우 공개 문제 추적기에 의견을 공유하세요.

라이선스 요건

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

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

이전
평가 기간