Calificaciones

En este documento, se presentan conceptos de calificación relevantes para la API de Classroom.

Consulta el artículo Califica tareas y haz un seguimiento de ellas para obtener información sobre los procesos de calificación de los profesores en la app de Google Classroom.

Trabajo del curso y envíos

En Google Classroom, los estudiantes entregan StudentSubmissions para las tareas de CourseWork en su Course. CourseWork se puede calificar o no. Si se califica una CourseWork, tiene un valor 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 muestra el envío en la app de Classroom, se configura un assignedGrade automáticamente 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 configurar una assignedGrade sin una draftGrade. Ambos campos se representan con decimales y, si no se establecen, 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 de lectura, configuración y devolución de calificaciones.

Los estudiantes pueden enviar varias entregas a la misma tarea de CourseWork, y el estado de entrega y el historial de calificaciones se registran en StudentSubmission.submissionHistory.

Tardío, excusado y falta de trabajo del curso

Cuando se asignan elementos CourseWork, se crean marcadores de posición StudentSubmissions para cada estudiante, incluso si no interactuó con la tarea correspondiente. Los profesores pueden configurar un dueDate en el CourseWork, y los StudentSubmissions asociados se marcarán con un campo late (configurado en true) si el estudiante no entrega la tarea antes de la fecha. Los profesores también pueden inhabilitar las entregas tardías con un parámetro de configuración en la app de Classroom.

Además, los StudentSubmissions que no se envíen antes del dueDate se anotarán en el libro de calificaciones de Classroom como faltantes. Los profesores también pueden marcar las entregas como faltantes de forma manual en la app de Classroom. Las tareas sin entregar reciben automáticamente una draftGrade, que el profesor puede personalizar, pero que se establece de forma predeterminada en 0.

El profesor puede marcar las entregas faltantes como completas o excusadas. Los StudentSubmissions marcados como completos tienen su campo draftGrade predeterminado quitado hasta que el profesor establezca uno nuevo de forma manual. Los StudentSubmissions marcados como excusados se quitan de los cálculos de puntuación general, incluidos los períodos de calificación.

Consulta el artículo de ayuda Cómo calificar y devolver una tarea para obtener más información sobre cómo los profesores pueden controlar 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, ponderarse por categoría o no calcularse en absoluto.

Consulta el artículo Cómo configurar la calificación para obtener información sobre los diferentes sistemas de calificación con ejemplos.

Algunos puntos clave:

• El recurso Course tiene un objeto gradebookSettings con detalles sobre la configuración de la calificación del curso.
  • calculationType especifica el método de cálculo para el curso.
  • displaySettings especifica 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.
  • gradeCategories contiene 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 una categoría no esté presente. Por ejemplo, si las ponderaciones de las categorías fueran del 20% para las tareas, del 10% para los problemas de práctica y del 70% para los cuestionarios, pero no hubiera problemas de práctica, Classroom ajustaría las ponderaciones a un 22% para las tareas y un 78% para los cuestionarios cuando calcule las calificaciones generales. Si quieres duplicar las calificaciones generales de Classroom en tu aplicación, deberás hacer lo mismo.

Períodos de calificación

Los profesores pueden agrupar CourseWork tareas de un curso en distintos períodos, 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 grupos distintos para los cálculos de la calificación general.

Por ejemplo, un profesor podría crear períodos de calificación para los semestres de “primavera” y “otoño”. La puntuación de calificación general para el período de la primavera solo incluiría StudentSubmissions que vencerán en ese período.

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 establecieran en un curso que usara categorías de calificación ponderadas, en última instancia, habría tres conjuntos de calificaciones generales para los estudiantes:

• Calificación general de todas las tareas del curso.
• La calificación general de todas las tareas del período de primavera.
• Calificación general de todas las tareas del período de otoño.

Los 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 encuentra 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 las StudentSubmissions correspondientes.

Consulta el artículo de rúbricas para aprender cómo los profesores pueden usarlas en Classroom.

Las rúbricas extienden el recurso StudentSubmissions con campos adicionales:

• rubricId identifica la rúbrica que corresponde al CourseWork del envío.
• draftRubricGrades representa los criterios y las puntuaciones de los marcadores de posición que el profesor redactó antes de devolver el envío al estudiante.
• assignedRubricGrades representa 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 rubricas para aprender a administrar las rúbricas y leer las calificaciones relacionadas con la API.

Escalas de calificación

Classroom admite escalas de calificación personalizables, por ejemplo, lo que permite que los profesores traduzcan las calificaciones numéricas a calificaciones con letras. Esta configuración y los datos correspondientes no están disponibles en la API.