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 vale la pena destacar cuando se usa la API para interactuar con las rúbricas:

  • Hay (como máximo) una sola rúbrica asociada a un CourseWork, y esa rúbrica es exclusiva de ese CourseWork (no se puede compartir entre recursos de CourseWork).
  • La rúbrica consta de criterios, que a su vez 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 pueden tener puntuación (tener puntos) o no tenerla (no tener puntos). Los niveles deben calificarse por completo o no calificarse en absoluto en una rúbrica.
    • Si los niveles se califican, 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 el 0. No se aceptan valores nulos. Además, una rúbrica no puede tener un solo criterio con un solo nivel de 0 puntos.
    • Si los niveles no tienen una puntuación, se debe omitir el campo de 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 ascendente o descendente.
  • Puede haber hasta 50 criterios por rúbrica y hasta 10 niveles de rendimiento por criterio.

Los objetos StudentSubmission admiten campos relacionados con rúbricas:

  • Además de las propiedades draftGrade y assignedGrade existentes, un envío de estudiante calificado con una rúbrica tiene propiedades draftRubricGrades y assignedRubricGrades. Representan las calificaciones de la rúbrica (niveles seleccionados y valores de puntos) que el estudiante recibe durante la calificación de la rúbrica, en los estados de borrador y asignado, respectivamente.
  • Por el momento, estas propiedades son de solo lectura. Esto significa que no se puede usar la API para calificar entregas, pero sí puedes leer las entregas calificadas en la IU de Classroom.

Comportamientos de las rúbricas

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

  • Las rúbricas tienen como objetivo guiar la calificación sin limitar a los profesores. Como resultado, un profesor puede hacer lo siguiente cuando califica un envío 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 a un criterio sin seleccionar un 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 admite comportamientos que la IU de Classroom ya no tiene. Por ejemplo, la API no permite aplicar el uso de rúbricas en las tareas ni anular la capacidad de un profesor para editar rúbricas y entregas como lo hace actualmente.

Limitaciones durante la calificación

Del mismo modo, existen algunas limitaciones adicionales para editar rúbricas una vez que un profesor comenzó a calificar con ellas. Solo se pueden realizar los siguientes cambios después de que se haya iniciado la calificación:

  • Se permiten las 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 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 es posible que tu aplicación deba estar verificada.

Trabajos de curso de terceros

Solo el proyecto de Google Cloud que creó el elemento CourseWork principal puede crear rúbricas. Este es un patrón de diseño más amplio en la API de Classroom que evita que diferentes aplicaciones afecten los recursos que no les pertenecen.

Esto se extiende a los recursos creados por los usuarios en la app de Classroom. Por ejemplo, una aplicación no puede administrar las rúbricas de un trabajo de curso que un profesor creó en la IU de Classroom, incluso si el mismo profesor es propietario de la aplicación. Si esto limita significativamente tu caso de uso, comparte tus comentarios en la herramienta pública de seguimiento de errores.

Requisitos de licencias

Un usuario solo puede crear, actualizar y borrar rúbricas con la API de Classroom si se cumplen las siguientes condiciones:

Consulta la elegibilidad del usuario para obtener más información sobre cómo se exponen las capacidades de la API a los usuarios y los requisitos previos de la API de Classroom para familiarizarte con una cuenta de demostración para el desarrollo y solicitarla.

Anterior
Períodos de calificación