Consulte google.classroom.v1.Rubric para saber quais campos podem ser atualizados. Os recursos de atualização da rubrica são limitados quando a avaliação começa.
O usuário solicitante e o proprietário do curso precisam ter capacidade de criar avaliações. Para mais detalhes, consulte os requisitos de licenciamento.
Essa solicitação precisa ser feita pelo console do Google Cloud do ID do cliente OAuth usado para criar o item de trabalho do curso pai.
Esse método retorna os seguintes códigos de erro:
PERMISSION_DENIED se o projeto do desenvolvedor solicitante não criou o trabalho do curso correspondente, se o usuário não tem permissão para fazer a modificação solicitada na rubrica ou por erros de acesso. Esse código de erro também é retornado se a avaliação já tiver começado na rubrica.
INVALID_ARGUMENT se a solicitação estiver incorreta e para o seguinte erro de solicitação:
RubricCriteriaInvalidFormat
NOT_FOUND se o curso, o trabalho do curso ou a rubrica solicitados não existirem ou se o usuário não tiver acesso ao trabalho do curso correspondente.
INTERNAL se a avaliação já tiver começado na rubrica.
Opcional. Máscara que identifica quais campos da rubrica serão atualizados. Este campo é obrigatório para fazer uma atualização. A atualização falha se campos inválidos forem especificados. Há várias opções para definir os critérios de uma rubrica: a sourceSpreadsheetId e a lista criteria. Apenas uma delas pode ser usada por vez para definir uma rubrica.
A lista de criteria da rubrica é totalmente substituída pelos critérios de rubrica especificados na solicitação de atualização. Por exemplo, se um critério ou nível estiver ausente na solicitação, ele será excluído. Novos critérios e níveis são adicionados, e um ID é atribuído. Os critérios e níveis atuais mantêm o ID atribuído anteriormente se ele for especificado na solicitação.
Os professores podem especificar os seguintes campos:
criteria
sourceSpreadsheetId
É uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".
Opcional. A versão de pré-lançamento da API. É necessário definir esse valor para acessar os novos recursos de API disponibilizados para os desenvolvedores no programa de visualização.
Corpo da solicitação
O corpo da solicitação contém uma instância de Rubric.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Rubric.
[null,null,["Última atualização 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)."]]
