En este documento, se presentan los conceptos de calificación relevantes para la API de Classroom.
Consulta el artículo sobre cómo calificar y hacer un seguimiento de las tareas para obtener información sobre los recorridos de calificación de los profesores en la app de Google Classroom.
CourseWork y StudentSubmissions
En Google Classroom, los estudiantes entregan StudentSubmissions para las tareas CourseWork en su Course. CourseWork se puede calificar o no. Si se califica un CourseWork, tiene un valor de maxPoints que representa la cantidad total de puntos que vale la tarea. Si maxPoints es cero o no se especifica, la tarea no se califica.
En el caso de las tareas calificadas, los profesores establecen una calificación draftGrade en la StudentSubmission antes de devolverla al estudiante. Cuando se devuelve el envío en la app de Classroom, se establece automáticamente un assignedGrade en el StudentSubmission, con el mismo valor que el draftGrade actual. Los desarrolladores pueden configurar ambos campos y deben emular el comportamiento de la app de Classroom. Por ejemplo, no se puede establecer un assignedGrade sin un draftGrade. Ambos campos se representan con números decimales y, si no se configuran, implican que el profesor aún no estableció la calificación correspondiente.
Consulta cómo crear y administrar calificaciones para ver ejemplos de código sobre cómo leer, establecer y devolver calificaciones.
Los estudiantes pueden enviar varias entregas para la misma tarea de CourseWork, y el estado de la entrega y el historial de calificaciones se registran en StudentSubmission.submissionHistory.
Trabajos del curso atrasados, justificados y faltantes
Cuando se asignan elementos CourseWork, se crean marcadores de posición StudentSubmissions para cada estudiante, incluso si este no interactuó con la tarea correspondiente. Los profesores pueden establecer un dueDate en el CourseWork, y los StudentSubmissions asociados se marcan con un campo late (configurado como true) si el estudiante no entrega la tarea antes de la fecha. Los profesores también pueden inhabilitar las entregas atrasadas con un parámetro de configuración en la app de Classroom.
Además, los StudentSubmissions que no se envían antes de dueDate se anotan como faltantes en el libro de calificaciones de Classroom. Los profesores también pueden marcar las entregas como faltantes de forma manual en la app de Classroom. Las tareas faltantes reciben automáticamente un draftGrade, que el profesor puede personalizar, pero que, de forma predeterminada, es 0.
El profesor puede marcar las entregas faltantes como completadas o excusadas.
Los StudentSubmissions marcados como completados tienen su campo draftGrade predeterminado quitado hasta que el profesor establezca uno nuevo de forma manual. Las StudentSubmissions marcadas como excusadas se quitan de los cálculos de la puntuación general, incluidos los períodos de calificación.
Consulta el artículo de ayuda sobre cómo calificar y devolver una tarea para obtener más información sobre cómo los profesores pueden manejar las entregas.
Calificación general y sistemas de calificación
Classroom admite varios sistemas de calificación para calcular las calificaciones generales de los estudiantes en el curso. Las calificaciones generales se pueden calcular directamente a partir del total de puntos, ponderadas por categoría o no calcularse en absoluto.
Consulta el artículo sobre cómo configurar la calificación para obtener información sobre los diferentes sistemas de calificación con ejemplos.
Algunos puntos clave:
- El recurso
Coursetiene un objetogradebookSettingscon detalles sobre la configuración de calificaciones del curso.calculationTypeespecifica el método de cálculo del curso.displaySettingsespecifica quién puede ver las calificaciones generales en la app de Classroom. Es una práctica recomendada respetar esto en tu propia aplicación cuando sea posible. Por ejemplo, si los estudiantes no pueden ver su calificación general en Classroom, no se la muestres en tu app.gradeCategoriescontiene una lista de las categorías de calificación configuradas para el curso, incluidos sus nombres visibles, el porcentaje de ponderación y los puntos predeterminados para las tareas correspondientes.
- Si un curso usa calificaciones ponderadas, es posible que debas normalizar los pesos en situaciones en las que no haya una categoría. Por ejemplo, si los pesos de las categorías fueran del 20% para las tareas, el 10% para los problemas de práctica y el 70% para los cuestionarios, pero en realidad no hubiera problemas de práctica, Classroom ajustaría los pesos a un 22% para las tareas y un 78% para los cuestionarios cuando se calculen las calificaciones generales. Si planeas reflejar las calificaciones generales de Classroom en tu aplicación, deberás hacer lo mismo.
Períodos de calificación
Los profesores pueden agrupar las CourseWork tareas de un curso en distintos rangos de fechas llamados períodos de calificación. Los períodos de calificación se pueden usar para filtrar el trabajo del curso en la vista del libro de calificaciones y crear distintos grupos para los cálculos de la calificación general.
Por ejemplo, un profesor puede crear períodos de calificación para los semestres de "primavera" y "otoño". La calificación general del período de primavera solo incluiría las tareas StudentSubmissions que se deban entregar en el período de primavera.
El sistema de calificación establecido para el curso se extiende a los períodos de calificación. Por lo tanto, si los períodos de calificación de primavera y otoño mencionados anteriormente se establecieron en un curso que usaba categorías de calificación ponderadas, en última instancia, habría tres conjuntos de calificaciones generales para los estudiantes:
- Es la calificación general de todas las tareas del curso.
- Es la calificación general de todas las tareas en el período de primavera.
- Es la calificación general de todas las tareas en el período de otoño.
Las tres calcularían la calificación general con categorías ponderadas.
Consulta el anuncio sobre los períodos de calificación para obtener una descripción general de la función.
Los períodos de calificación extienden CourseWork con un gradingPeriodId que identifica el período de calificación en el que se incluye la tarea.
Consulta la guía de la API de períodos de calificación para aprender a leer y administrar períodos de calificación con la API.
Rúbricas
Los profesores pueden crear y asociar Rubrics con tareas de CourseWork, y usar estas rúbricas como guía cuando califiquen los StudentSubmissions correspondientes.
Consulta el artículo sobre rúbricas para obtener información sobre cómo los profesores pueden usar las rúbricas en Classroom.
Las rúbricas extienden el recurso StudentSubmissions con campos adicionales:
rubricIdidentifica la rúbrica que corresponde alCourseWorkdel envío.draftRubricGradesrepresenta los criterios y las calificaciones de marcador de posición que el profesor redactó antes de devolver la entrega al estudiante.assignedRubricGradesrepresenta los criterios y las puntuaciones que recibe el estudiante después de que el profesor devuelve la entrega.
Consulta la guía de la API de rúbricas para obtener información sobre cómo administrar rúbricas y leer calificaciones relacionadas con la API.
Escalas de calificación
Classroom admite escalas de calificación personalizables, por ejemplo, permite que los profesores traduzcan las calificaciones numéricas en calificaciones con letras. Estos parámetros de configuración y los datos correspondientes no están disponibles en la API.