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 califica por rúbricas en la IU de Classroom.

Estructura de las rúbricas

Existen 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 con un CourseWork y esa rúbrica es única para ese CourseWork (no se puede compartir entre los recursos 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 calificar (tener puntos) o no (no tener puntos). Los niveles deben estar completamente calificados o no calificados en una rúbrica.
    • Si los niveles están calificados, 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 están calificados, 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 que se representan en la IU de Classroom.
    • En particular, los niveles calificados 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.

StudentSubmission objetos admiten campos relacionados con las rúbricas:

  • Además de las propiedades draftGrade y assignedGrade existentes, una entrega de estudiante calificada con una rúbrica tiene propiedades draftRubricGrades y assignedRubricGrades. Estas 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 ahora, estas propiedades son de solo lectura. Esto significa que no se puede usar la API para calificar entregas, pero 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 lograr coherencia, pero esto puede generar un comportamiento que no sea intuitivo para los desarrolladores y que vale la pena mencionar:

  • Las rúbricas están diseñadas para 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 cuando califica
    • Anular los puntos de un criterio, independientemente de los puntos disponibles en los niveles del criterio
    • Seleccionar niveles solo para un subconjunto de criterios
    • Asignar puntos a un criterio sin seleccionar un 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 admite el comportamiento 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 para editar rúbricas y entregas 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 comenzó a calificar con ellas. Solo se pueden realizar las siguientes ediciones después de que se inicia 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

Los profesores pueden exportar las rúbricas manualmente a Hojas de cálculo de Google para volver a usarlas.

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 https://www.googleapis.com/auth/spreadsheets.readonly o el https://www.googleapis.com/auth/spreadsheets permiso. Ten en cuenta que los spreadsheets alcances se consideran sensibles y pueden requerir que se verifique tu aplicación .

Trabajo de curso 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 impide que diferentes aplicaciones afecten recursos que no son suyos.

Esto se extiende a los recursos creados por los usuarios en la app de Classroom. Por ejemplo, una aplicación no puede administrar rúbricas para 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 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