Estructura de rúbricas y limitaciones conocidas

Si no estás familiarizado con 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 de rúbricas en la IU de Classroom.

Estructura de las rúbricas

Hay algunos conceptos importantes que pueden valer la pena destacar cuando usas la API para interactuar con las rúbricas:

  • Hay (como máximo) una sola rúbrica asociada con una CourseWork, y esa rúbrica es exclusiva de esa CourseWork (no se puede compartir entre los recursos de CourseWork).
  • La rúbrica consta de criterios, que constan de niveles. Una rúbrica siempre debe tener al menos un criterio, y un criterio siempre debe tener al menos un nivel.
  • Los niveles se pueden puntuar (tienen puntos) o no (ningún punto). Los niveles deben estar totalmente puntuados o no en una rúbrica.
    • Si se califican 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 nivel único de 0 puntos.
    • Si los niveles no tienen puntuación, se debe omitir el campo de puntos. No se aceptan valores nulos.
  • El orden de los criterios y niveles es significativo y refleja el orden en que se representan en la IU de Classroom.
    • Los niveles de puntuación en particular siempre deben ordenarse por puntos, ya sea en orden ascendente o descendente.
  • Puede haber hasta 50 criterios por rúbrica y hasta 10 niveles de rendimiento por criterio.

Los objetos de Entrega de los alumnos también cambiarán:

  • Además de las propiedades existentes draftGrade y assignedGrade, una entrega de un alumno calificada con una rúbrica tiene las propiedades draftRubricGrades y assignedRubricGrades. Estas representan las calificaciones de la rúbrica (niveles seleccionados y valores de puntuación) que el alumno recibe durante la calificación desde la rúbrica, en el estado preliminar y asignado, respectivamente.
  • Por el momento, estas propiedades son de solo lectura. Esto significa que la API no se puede usar para calificar las entregas, pero puedes leerlas en la IU de Classroom.
  • Las entregas de los alumnos con una rúbrica asociada contienen un campo rubricId. Este campo representa la rúbrica más reciente asociada con 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 lograr la coherencia, pero esto puede generar comportamientos que podrían resultar poco intuitivos para los desarrolladores y que vale la pena mencionar:

  • El objetivo de las rúbricas es guiar la calificación sin limitar a los profesores. Como resultado, los profesores pueden hacer lo siguiente cuando califican una entrega con una rúbrica:
    • Ignora por completo la rúbrica cuando califiques.
    • Anula los puntos de un criterio, sin importar los puntos disponibles en sus niveles.
    • Selecciona niveles solo para un subconjunto de criterios.
    • Asigna puntos a un criterio sin seleccionar un nivel correspondiente.
    • Anula el total de puntos de la tarea, independientemente de los que provengan de la rúbrica.

Además, la API no presenta ninguna función nueva del producto. En otras palabras, la API no admite comportamientos que la IU de Classroom aún no tiene. 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 lo hace en la actualidad.

Limitaciones durante la calificación

Del mismo modo, existen algunas limitaciones adicionales a la edición de rúbricas una vez que un profesor comienza a calificarlas. Solo las siguientes ediciones son posibles después de calificar como se inició:

  • Se permite editar texto para títulos y descripciones de criterios y niveles.
  • El orden de los niveles puede cambiar dentro de los criterios.

Alcances adicionales

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

Si creas o actualizas una rúbrica a partir de estas hojas de cálculo (consulta un ejemplo en la guía), tu aplicación debe solicitar el alcance 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 tu aplicación esté verificada.