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 califican los niveles, todos los niveles de un criterio deben tener un valor de puntos único. 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 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 creciente o decreciente.
• Se pueden incluir hasta 50 criterios por rúbrica y hasta 10 niveles de rendimiento por criterio.

Campos relacionados con las entregas de los estudiantes

Los objetos StudentSubmission admiten campos relacionados con las rúbricas:

• Además de las propiedades draftGrade y assignedGrade existentes, una entrega de un estudiante calificada con una rúbrica tiene propiedades draftRubricGrades y assignedRubricGrades. Estos 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 las entregas, pero puedes leer las entregas calificadas en la IU de Classroom.

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:
  • Ignora por completo la rúbrica cuando califiques.
  • Anula los puntos de un criterio, independientemente de los puntos disponibles en los niveles del criterio.
  • Selecciona niveles solo para un subconjunto de criterios.
  • Asignar puntos para un criterio sin seleccionar un nivel correspondiente
  • Anula el total de puntos de la tarea, independientemente de los puntos que provengan de la rúbrica.

Además, la API no admite comportamientos que la IU de Classroom aún no tiene. Por ejemplo, la API no permite aplicar el uso de rúbricas en las tareas ni anular la capacidad de un profesor de editar rúbricas y envíos como lo hacen hoy.

Limitaciones durante la calificación

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

• 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.

Cursos de terceros

Solo el proyecto de Google Cloud que creó el elemento CourseWork superior 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 son suyos.

Esto se extiende a los recursos que crean los usuarios en la app de Classroom. Por ejemplo, no es posible que una aplicación administre rúbricas para un trabajos 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:

• El usuario que realiza la solicitud tiene asignada una licencia de Google Workspace for Education Plus.
• El propietario del curso correspondiente tiene asignada una licencia de Google Workspace for Education Plus.

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