선택사항입니다. 업데이트할 평가 기준의 필드를 식별하는 마스크입니다. 이 입력란은 업데이트를 수행하는 데 필요합니다. 잘못된 필드를 지정하면 업데이트가 실패합니다. sourceSpreadsheetId 및 criteria 목록 등 평가 기준을 정의하는 옵션은 여러 가지가 있습니다. 한 번에 하나의 기준만 사용하여 기준을 정의할 수 있습니다.
평가 기준 criteria 목록이 업데이트 요청에 지정된 평가 기준으로 완전히 대체됩니다. 예를 들어 요청에서 기준 또는 수준이 누락되면 삭제됩니다. 새로운 기준과 수준이 추가되고 ID가 할당됩니다. 기존 기준 및 수준은 요청에 ID가 지정된 경우 이전에 할당된 ID를 유지합니다.
교사는 다음 필드를 지정할 수 있습니다.
criteria
sourceSpreadsheetId
정규화된 필드 이름의 쉼표로 구분된 목록입니다. 예: "user.displayName,photo"
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[],[],null,["# Method: courses.courseWork.rubrics.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates a rubric.\n\nSee [google.classroom.v1.Rubric](/workspace/classroom/reference/rest/v1/courses.courseWork.rubrics#Rubric) for details of which fields can be updated. Rubric update capabilities are [limited](/classroom/rubrics/limitations) once grading has started.\n\nThe requesting user and course owner must have rubrics creation capabilities. For details, see [licensing requirements](https://developers.google.com/workspace/classroom/rubrics/limitations#license-requirements).\n\nThis request must be made by the Google Cloud console of the [OAuth client ID](https://support.google.com/cloud/answer/6158849) used to create the parent course work item.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if the requesting developer project didn't create the corresponding course work, if the user isn't permitted to make the requested modification to the rubric, or for [access errors](/workspace/classroom/reference/Access.Errors). This error code is also returned if grading has already started on the rubric.\n- `INVALID_ARGUMENT` if the request is malformed and for the following [request error](/workspace/classroom/reference/Request.Errors):\n - `RubricCriteriaInvalidFormat`\n- `NOT_FOUND` if the requested course, course work, or rubric doesn't exist or if the user doesn't have access to the corresponding course work.\n- `INTERNAL` if grading has already started on the rubric.\n\n### HTTP request\n\n`PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|---------------------------------------------------|\n| `courseId` | `string` Required. Identifier of the course. |\n| `courseWorkId` | `string` Required. Identifier of the course work. |\n| `id` | `string` Optional. Identifier of the rubric. |\n\n### Query parameters\n\n| Parameters ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Optional. Mask that identifies which fields on the rubric to update. This field is required to do an update. The update fails if invalid fields are specified. There are multiple options to define the criteria of a rubric: the `sourceSpreadsheetId` and the `criteria` list. Only one of these can be used at a time to define a rubric. The rubric `criteria` list is fully replaced by the rubric criteria specified in the update request. For example, if a criterion or level is missing from the request, it is deleted. New criteria and levels are added and an ID is assigned. Existing criteria and levels retain the previously assigned ID if the ID is specified in the request. The following fields can be specified by teachers: - `criteria` - `sourceSpreadsheetId` This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n| `previewVersion` | `enum (`[PreviewVersion](/workspace/classroom/reference/rest/v1/PreviewVersion)`)` Optional. The preview version of the API. This must be set in order to access new API capabilities made available to developers in the Preview Program. |\n\n### Request body\n\nThe request body contains an instance of [Rubric](/workspace/classroom/reference/rest/v1/courses.courseWork.rubrics#Rubric).\n\n### Response body\n\nIf successful, the response body contains an instance of [Rubric](/workspace/classroom/reference/rest/v1/courses.courseWork.rubrics#Rubric).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.coursework.students`\n| **Important:** Creating a rubric from a Google Sheet by specifying the `sourceSpreadsheetId` requires additional scopes: either `https://www.googleapis.com/auth/spreadsheets.readonly` or `https://www.googleapis.com/auth/spreadsheets`. Be aware that the `spreadsheets` scopes are considered sensitive and may require your application to be [verified](https://support.google.com/cloud/answer/9110914).\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
