Los complementos de Google Classroom ya están en fase de disponibilidad general para desarrolladores. Consulta la documentación sobre complementos para obtener más información.
Consulta google.classroom.v1.Rubric para obtener detalles sobre qué campos se pueden actualizar. Las capacidades de actualización de la rúbrica son limitadas una vez que comienza la calificación.
El usuario solicitante y el propietario del curso deben tener capacidades de creación de rúbricas. Para obtener más información, consulta los requisitos de licencias.
La consola de Google Cloud debe realizar esta solicitud del ID de cliente de OAuth que se usó para crear el elemento de trabajo del curso superior.
Este método muestra los siguientes códigos de error:
PERMISSION_DENIED si el proyecto del desarrollador solicitante no creó la tarea del curso correspondiente, si el usuario no tiene permiso para realizar la modificación solicitada en la rúbrica o por errores de acceso. Este código de error también se muestra si ya se comenzó a calificar en la rúbrica.
INVALID_ARGUMENT si la solicitud tiene un formato incorrecto y por el siguiente error de solicitud:
RubricCriteriaInvalidFormat
NOT_FOUND si el curso, la tarea o la rúbrica solicitados no existen, o si el usuario no tiene acceso a la tarea correspondiente.
INTERNAL si ya se comenzó a calificar en la rúbrica.
Opcional. Es una máscara que identifica qué campos de la rúbrica se deben actualizar. Este campo es obligatorio para realizar una actualización. La actualización fallará si se especifican campos no válidos. Existen varias opciones para definir los criterios de una rúbrica: sourceSpreadsheetId y la lista criteria. Solo se puede usar uno de estos a la vez para definir una rúbrica.
La lista criteria de la rúbrica se reemplaza por completo por los criterios de la rúbrica especificados en la solicitud de actualización. Por ejemplo, si falta un criterio o nivel en la solicitud, se borra. Se agregan criterios y niveles nuevos, y se asigna un ID. Los criterios y niveles existentes retienen el ID asignado anteriormente si se especifica en la solicitud.
Los profesores pueden especificar los siguientes campos:
criteria
sourceSpreadsheetId
Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: "user.displayName,photo".
Opcional. La versión preliminar de la API. Se debe configurar para acceder a las nuevas funciones de la API que se ponen a disposición de los desarrolladores en el programa de versión preliminar.
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de Rubric.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Rubric.
[null,null,["Última actualización: 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)."]]
