Method: courses.courseWork.rubrics.patch

• Solicitud HTTP
• Parámetros de ruta de acceso
• Parámetros de consulta
• Cuerpo de la solicitud
• Cuerpo de la respuesta
• Permisos de autorización

Versión preliminar para desarrolladores: Disponible como parte del Programa de versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones. Esta función está disponible en V1_20231110_PREVIEW y versiones posteriores. Consulta Cómo acceder a las APIs de vista previa para obtener más información.

Actualiza una rúbrica.

Consulta google.classroom.v1.Rubric para obtener detalles sobre los campos que se pueden actualizar. Las funciones de actualización de las rúbricas son limitadas una vez que se inicia la calificación.

Esta solicitud debe realizarse a través de la consola de Google Cloud 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 de desarrollador solicitante no creó el trabajo del curso correspondiente, si el usuario no tiene permiso para realizar la modificación solicitada en la rúbrica o errores de acceso. También se muestra este código de error si ya comenzó la calificación en la rúbrica.
• INVALID_ARGUMENT si la solicitud tiene un formato incorrecto y ocurre el siguiente error de solicitud:
  • RubricCriteriaInvalidFormat
• NOT_FOUND si el curso, el trabajo del curso o la rúbrica solicitados no existen o si el usuario no tiene acceso al trabajo del curso correspondiente.
• INTERNAL si ya comenzó la calificación en la rúbrica.

Solicitud HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
courseId	string Obligatorio. Es el identificador del curso.
courseWorkId	string Obligatorio. Es el identificador del trabajo del curso.
id	string Opcional. Identificador de la rúbrica.

Parámetros de consulta

Parámetros
updateMask	string (FieldMask format) Opcional. 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 falla si se especifican campos no válidos. Existen varias opciones para definir los criterios de una rúbrica: las listas sourceSpreadsheetId y criteria. Solo se puede usar una de estas opciones a la vez para definir una rúbrica. La lista de la rúbrica criteria se reemplazó 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 borrará. Se agregan nuevos criterios y niveles, y se asigna un ID. Los criterios y niveles existentes conservan 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 completamente calificados. Ejemplo: "user.displayName,photo".
previewVersion	enum (PreviewVersion) Opcional. Es la versión preliminar de la API. Esto se debe configurar para acceder a las nuevas funciones de la API que están disponibles para los desarrolladores en el Programa de versión preliminar.

Cuerpo de la solicitud

El cuerpo de la solicitud incluye una instancia de Rubric.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Rubric.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

• https://www.googleapis.com/auth/classroom.coursework.students
Importante: Para crear una rúbrica a partir de una hoja de cálculo de Google especificando sourceSpreadsheetId, se requieren permisos adicionales: https://www.googleapis.com/auth/spreadsheets.readonly o https://www.googleapis.com/auth/spreadsheets. Ten en cuenta que los permisos de spreadsheets se consideran sensibles y pueden requerir que se verifique tu aplicación.

Para obtener más información, consulta la guía de autorización.