Estructura de rúbricas y limitaciones conocidas

Si no conoces las rúbricas de Classroom, consulta estos artículos del Centro de ayuda para obtener información sobre la estructura general de una rúbrica y cómo se realiza la calificación con rúbricas en la IU de Classroom.

Estructura de las rúbricas

Hay algunos conceptos importantes que pueden ser útiles destacar cuando se usa la API para interactuar con las rúbricas:

  • Hay (como máximo) una sola rúbrica asociada con un CourseWork y esa rúbrica es única para ese CourseWork (no se puede compartir entre recursos de CourseWork).
  • La rúbrica consta de criterios, que se componen de niveles. Una rúbrica siempre debe tener al menos un criterio, y un criterio siempre debe tener al menos un nivel.
  • Los niveles pueden tener o no puntuación. Los niveles deben tener una puntuación completa o no tener puntuación en una rúbrica.
    • Si se asigna una puntuación a los niveles, todos los niveles de un criterio deben tener un valor de puntos único establecido. Los puntos pueden ser números enteros (como 10) o valores de punto flotante (como 9.99). Esto puede incluir 0. No se aceptan valores nulos. Además, una rúbrica no puede tener un solo criterio con un solo nivel que sea de 0 puntos.
    • Si los niveles no tienen puntuación, se debe omitir el campo puntos; no se aceptan valores nulos.
  • El orden de los criterios y los niveles es significativo y refleja el orden en el que se representan en la IU de Classroom.
    • En particular, los niveles con puntuación siempre deben ordenarse por puntos en orden creciente o decreciente.
  • Se pueden incluir hasta 50 criterios por rúbrica y hasta 10 niveles de rendimiento por criterio.

Los objetos Entrega del estudiante también cambiarán:

  • Además de las propiedades draftGrade y assignedGrade existentes, una entrega de un estudiante calificada con una rúbrica tiene propiedades draftRubricGrades y assignedRubricGrades. Estas representan las calificaciones de la rúbrica (niveles seleccionados y puntuaciones) que recibe el estudiante durante la calificación de la rúbrica, en el estado borrador y en el estado asignado, respectivamente.
  • Por el momento, estas propiedades son de solo lectura. Esto significa que no se puede usar la API para calificar las entregas, pero puedes leer las entregas calificadas en la IU de Classroom.
  • Las entregas de los estudiantes con una rúbrica asociada contienen un campo rubricId. Este campo representa la rúbrica más reciente asociada con el CourseWork, y este valor puede cambiar si los profesores borran y vuelven a crear una rúbrica.

Comportamientos de las rúbricas

El objetivo de la API es duplicar la IU de Classroom siempre que sea posible para mantener la coherencia, pero esto puede generar un comportamiento que puede no ser intuitivo para los desarrolladores y que vale la pena mencionar:

  • El objetivo de las rúbricas es guiar la calificación sin restringir a los profesores. Como resultado, un profesor puede hacer lo siguiente cuando califica una entrega con una rúbrica:
    • Ignorar por completo la rúbrica al calificar
    • Anula los puntos de un criterio, independientemente de los puntos disponibles en los niveles del criterio.
    • Selecciona niveles solo para un subconjunto de criterios.
    • Asigna puntos para un criterio sin seleccionar el nivel correspondiente.
    • Anula el total de puntos de la tarea, independientemente de los puntos que provendrían de la rúbrica.

Además, la API no presenta ninguna función de producto nueva. En otras palabras, la API no admite comportamientos que la IU de Classroom ya no tenga. Por ejemplo, la API no permite aplicar de manera forzosa el uso de rúbricas en las tareas ni anular la capacidad de un profesor para editar rúbricas y entregas como puede hacerlo actualmente.

Limitaciones durante la calificación

Del mismo modo, existen algunas limitaciones adicionales en la edición de rúbricas una vez que un profesor comienza a calificar con ellas. Después de calificar como iniciada, solo se pueden realizar las siguientes ediciones:

  • Se permiten ediciones de texto para los títulos y las descripciones de los criterios y los niveles.
  • El orden de los niveles puede cambiar dentro de los criterios.

Alcances adicionales

Las rúbricas se pueden exportar manualmente a Hojas de cálculo de Google para que los profesores las vuelvan a usar.

Si creas o actualizas una rúbrica desde estas hojas de cálculo (consulta un ejemplo en la guía), tu aplicación debe solicitar el permiso https://www.googleapis.com/auth/spreadsheets.readonly o https://www.googleapis.com/auth/spreadsheets. Ten en cuenta que los permisos spreadsheets se consideran sensibles y es posible que se requiera que tu app se verifique.

Anterior
Períodos de calificación