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 más información sobre la estructura general de una rúbrica y cómo se realiza la calificación de rúbrica en la IU de Classroom.

Estructura de las rúbricas

Existen algunos conceptos importantes que vale la pena destacar cuando se utiliza el API para interactuar con rúbricas:

  • Hay (como máximo) una única rúbrica asociada con una CourseWork y esa rúbrica es exclusiva de ese CourseWork (no se puede compartir en CourseWork).
  • La rúbrica consta de criterios, que constan de niveles. Una rúbrica debe tener siempre al menos un criterio, y un criterio siempre debe tener al menos un nivel.
  • Los niveles pueden calificarse (tener puntos) o no (ningún punto). Los niveles deben ser o que se les haya puntuado completamente o no en una rúbrica.
    • Si se asigna una puntuación a los niveles, todos los niveles de un criterio deben tener un de puntuación establecida. Los puntos pueden ser números enteros (como 10) o un punto flotante de salida (como 9.99). Puede incluir 0. No se aceptan valores nulos. Además, una rúbrica no puede tener un único criterio con un único nivel es decir, 0 puntos.
    • Si los niveles no tienen calificación, se debe omitir el campo de puntos. nulo no se aceptan valores.
  • El orden de los criterios y 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 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 estudiantes también cambiarán:

  • Además de las propiedades existentes de draftGrade y assignedGrade, se incluye un la entrega del estudiante calificada con una rúbrica tiene draftRubricGrades y assignedRubricGrades. Estas representan las calificaciones de las rúbricas (niveles (seleccionadas y puntuaciones) que recibe el estudiante durante la calificación del rúbrica, en los estados de borrador y asignados, respectivamente.
  • Por el momento, estas propiedades son de solo lectura. Esto significa que la API no puede que se usan para calificar las entregas, pero puedes leer las que se califican 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 CourseWork, y este valor puede cambiar si los profesores borran una rúbrica y la vuelven a crear.

Comportamientos de las rúbricas

La API tiene como objetivo duplicar la IU de Classroom siempre que sea posible para mantener la coherencia, pero esto puede generar comportamientos que pueden ser poco intuitivos para los desarrolladores y que vale la pena Mencionando:

  • El objetivo de las rúbricas es guiar la calificación sin restringir a los profesores. Como resultado, un profesor puede hacer lo siguiente al calificar una entrega con una rúbrica:
    • Ignora por completo la rúbrica al calificar.
    • Anular los puntos de un criterio, independientemente de los que tengan en los niveles del criterio.
    • Selecciona niveles solo para un subconjunto de criterios.
    • Asigna puntos para un criterio sin seleccionar el nivel correspondiente.
    • Anular 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 otro 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 o anulando la capacidad de un profesor para editar rúbricas y entregas hoy mismo.

Limitaciones durante la calificación

Del mismo modo, existen algunas limitaciones adicionales para editar rúbricas una vez que un el profesor comenzó a calificar con él. Solo son posibles las siguientes ediciones después de calificando como iniciada:

  • Se permite la edición de texto en los títulos y las descripciones de los criterios y niveles.
  • El orden de los niveles puede cambiar dentro de los criterios.

Permisos adicionales

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

Si creas o actualizas una rúbrica a partir de estas hojas de cálculo (consulta un ejemplo en la ), tu aplicación debe solicitar la https://www.googleapis.com/auth/spreadsheets.readonly o Permiso https://www.googleapis.com/auth/spreadsheets. Ten en cuenta que el spreadsheets permisos se consideran sensibles y pueden requerir tu aplicación verificar.