클래스룸 루브릭에 익숙하지 않다면 다음 고객센터 도움말을 참고하여 루브릭의 일반적인 구조와 클래스룸 UI에서 루브릭 채점이 이루어지는 방식을 알아보세요.
기준표 구조
API를 사용하여 루브릭과 상호작용할 때 강조할 만한 몇 가지 중요한 개념이 있습니다.
CourseWork와 연결된 루브릭은 하나 (최대)이며, 이 루브릭은 해당 CourseWork에 고유합니다 (CourseWork 리소스 간에 공유할 수 없음).
루브릭은 수준으로 구성된 기준으로 구성됩니다. 평가 기준에는 항상 기준이 하나 이상 있어야 하며 기준에는 항상 등급이 하나 이상 있어야 합니다.
레벨은 점수가 부여되거나 (포인트 있음) 점수가 부여되지 않을 수 있습니다 (포인트 없음). 수준은 루브릭에서 완전히 점수가 매겨지거나 완전히 점수가 매겨지지 않아야 합니다.
수준에 점수가 부여된 경우 기준의 모든 수준에 고유한 점수 값이 설정되어 있어야 합니다. 포인트는 정수 (예: 10) 또는 부동 소수점 값 (예: 9.99)일 수 있습니다. 0을 포함할 수 있습니다. null 값은 허용되지 않습니다.
또한 기준표에는 0점인 단일 수준의 단일 기준이 있을 수 없습니다.
레벨에 점수가 매겨지지 않은 경우 포인트 필드를 생략해야 합니다. null 값은 허용되지 않습니다.
기존 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를 사용하여 루브릭을 생성, 업데이트, 삭제할 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["# Rubrics structure and known limitations\n\nIf unfamiliar with Classroom Rubrics, see these Help Center articles to learn\nabout the [general structure](https://support.google.com/edu/classroom/answer/9335069?co=GENIEPlatform%3DDesktop#zippy=%2Cdelete-an-assignments-rubric%2Cedit-an-assignments-rubric%2Cshare-rubrics-with-export-and-import%2Csee-an-assignments-rubric%2Cadd-a-rubric-to-an-existing-assignment%2Creuse-a-rubric%2Ccreate-a-rubric%2Crubric-overview) of a rubric and how [rubric grading](https://support.google.com/edu/classroom/answer/9335428?ref_topic=11599451&sjid=7396534141168895349-NA) is done in\nthe Classroom UI.\n\nRubrics structure\n-----------------\n\nThere are some important concepts that may be worth highlighting when using the\nAPI to interact with rubrics:\n\n- There is (at most) a single [rubric](/workspace/classroom/reference/rest/v1/courses.courseWork.rubrics) associated with a [`CourseWork`](/workspace/classroom/reference/rest/v1/courses.courseWork) and that rubric is unique to that `CourseWork` (it is not shareable across `CourseWork` resources).\n- The rubric consists of [criteria](/workspace/classroom/reference/rest/v1/courses.courseWork.rubrics#criterion), which consist of [levels](/workspace/classroom/reference/rest/v1/courses.courseWork.rubrics#level). A rubric must always have at least one criteria, and a criterion must always have at least one level.\n- Levels can be scored (have points) or unscored (no points). Levels must be entirely scored or entirely unscored in a rubric.\n - If the levels are scored, all levels in a criterion must have a unique points value set. Points can be integers (like 10) or floating point values (like 9.99). This can include 0. Null values are not accepted. Additionally, a rubric can't have a single criteria with a single level that is 0 points.\n - If the levels are unscored, the points field should be omitted; null values are not accepted.\n- The order for criteria and levels is meaningful and reflects the order they are represented in the Classroom UI.\n - Scored levels in particular must always be sorted by points in either increasing or decreasing order.\n- There can be up to 50 criteria per rubric and up to 10 performance levels per criterion.\n\nRelated student submission fields\n---------------------------------\n\n[`StudentSubmission`](/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions) objects support rubrics-related fields:\n\n- In addition to the existing `draftGrade` and `assignedGrade` properties, a student submission graded with a rubric has `draftRubricGrades` and `assignedRubricGrades` properties. These represent the rubric grades (levels selected and point values) the student receives during grading from the rubric, in the draft and assigned states, respectively.\n- For now, these properties are read-only. This means that *the API can't be\n used to grade submissions*, but you can read submissions graded in the Classroom UI.\n\nRubrics behaviors\n-----------------\n\nThe API aims to mirror the Classroom UI whenever possible for consistency, but\nthis can lead to behaviour that may be unintuitive for developers and is worth\nmentioning:\n\n- Rubrics are intended to *guide* grading without constraining teachers. As a result, a teacher can do the following when grading a submission with a rubric:\n - Completely ignore the rubric when grading.\n - Override the points for a criterion, irrespective of the points available in the criterion's levels.\n - Select levels for only a subset of criteria.\n - Assign points for a criteria without selecting a corresponding level.\n - Override the assignment's total points, irrespective of the points that would come from the rubric.\n\nAdditionally, the API doesn't support behavior the Classroom UI doesn't already\nhave. For example, the API doesn't enable enforcing rubrics usage on assignments\nor overriding a teacher's ability to edit rubrics and submissions as they can\ntoday.\n\nLimitations during grading\n--------------------------\n\nSimilarly, there are some additional limitations place on editing rubrics once a\nteacher has started grading with it. Only the following edits are possible after\ngrading as started:\n\n- Text edits are allowed for criterion and level titles and descriptions.\n- Level ordering can change within criteria.\n\nAdditional scopes\n-----------------\n\nRubrics can be manually [exported](https://support.google.com/edu/classroom/answer/9335069?co=GENIE.Platform%3DDesktop#zippy=%2Cshare-rubrics-with-export-and-import) to Google Spreadsheets for re-use by\nteachers.\n\nIf you create or update a rubric from these spreadsheets (see an [example in the\nguide](/workspace/classroom/rubrics/getting-started#export-and-import-rubrics)), your application needs to request the\n`https://www.googleapis.com/auth/spreadsheets.readonly` or\n`https://www.googleapis.com/auth/spreadsheets` scope. Be aware that the\n`spreadsheets` scopes are considered sensitive and may require your application\nto be [verified](https://support.google.com/cloud/answer/9110914).\n\nThird-party coursework\n----------------------\n\nRubrics can only be created by the Google Cloud project that created the parent\n`CourseWork` item. This is a broader design pattern in the\nClassroom API which prevents different applications from impacting\nresources that aren't thiers.\n\nThis extends to resources created by users in the Classroom app.\nFor example, It's not possible for an application to manage rubrics for a\ncoursework that a teacher created in the Classroom UI, even if\nthe same teacher owns the application. If this significantly limits your use\ncase, share feedback in the [public issue tracker](https://issuetracker.google.com/issues/new?component=191645&template=823907).\n\nLicense requirements\n--------------------\n\nA user can only create, update, and delete rubrics with the\nClassroom API if the following conditions are met:\n\n- The user making the request has a [Google Workspace for Education Plus](https://edu.google.com/intl/ALL_us/workspace-for-education/editions/compare-editions/) license assigned to them.\n- The course owner of the corresponding course has a [Google Workspace for Education Plus](https://edu.google.com/intl/ALL_us/workspace-for-education/editions/compare-editions/) license assigned to them.\n\nSee [user eligibility](/workspace/classroom/guides/key-concepts/user-eligibility) to learn more about how API\ncapabilities are exposed to users and Classroom API [prerequisites](https://developers.google.com/workspace/classroom/guides/onboarding/prerequisites) to\nbecome familiar with, and request, a demo account for development."]]
