Structure des grilles d'évaluation et limites connues

Si vous ne connaissez pas les grilles d'évaluation Classroom, consultez ces articles du centre d'aide pour en savoir plus sur la structure générale d'une grille et sur la notation avec une grille dans l'interface utilisateur de Classroom.

Structure des grilles d'évaluation

Voici quelques concepts importants à souligner lorsque vous utilisez l'API pour interagir avec les grilles d'évaluation:

  • Il n'y a (au maximum) qu'une seule rubrique associée à un CourseWork, et cette rubrique est propre à cet CourseWork (elle n'est pas partageable entre les ressources CourseWork).
  • La grille d'évaluation se compose de critères, qui se composent de niveaux. Une grille d'évaluation doit toujours comporter au moins un critère, et un critère doit toujours comporter au moins un niveau.
  • Les niveaux peuvent être notés (avec des points) ou non (sans points). Dans une grille d'évaluation, les niveaux doivent être entièrement notés ou non.
    • Si les niveaux sont évalués, une valeur de points unique doit être définie pour tous les niveaux d'un critère. Les points peuvent être des entiers (par exemple 10) ou des valeurs à virgule flottante (par exemple, 9,99). Cela peut inclure 0. Les valeurs NULL ne sont pas acceptées. De plus, une grille d'évaluation ne peut pas comporter un seul critère avec un seul niveau correspondant à 0 point.
    • Si les niveaux ne sont pas notés, le champ "points" doit être omis. Les valeurs nulles ne sont pas acceptées.
  • L'ordre des critères et des niveaux est pertinent et reflète l'ordre dans lequel ils sont représentés dans l'interface utilisateur de Classroom.
    • En particulier, les niveaux avec note doivent toujours être triés par points dans l'ordre croissant ou décroissant.
  • Vous pouvez créer jusqu'à 50 critères par grille d'évaluation et jusqu'à 10 niveaux de performance par critère.

Les objets Renvois des élèves changent également:

  • En plus des propriétés draftGrade et assignedGrade existantes, un devoir d'élève noté avec une grille d'évaluation comporte des propriétés draftRubricGrades et assignedRubricGrades. Celles-ci représentent les notes de la grille d'évaluation (niveaux sélectionnés et barèmes de notation) que l'élève reçoit lors de la notation dans la grille, à l'état "Brouillon" et à l'état attribué, respectivement.
  • Pour le moment, ces propriétés sont en lecture seule. Cela signifie que l'API ne peut pas être utilisée pour noter les devoirs, mais que vous pouvez lire les devoirs notés dans l'interface utilisateur de Classroom.
  • Les devoirs des élèves avec une grille d'évaluation associée contiennent un champ rubricId. Ce champ représente la dernière grille d'évaluation associée à CourseWork. Cette valeur peut changer si les enseignants suppriment et recréent une grille d'évaluation.

Comportements des grilles d'évaluation

L'API vise à refléter l'UI Classroom dans la mesure du possible pour assurer la cohérence, mais cela peut entraîner un comportement qui peut être peu intuitif pour les développeurs. Il est donc important de le mentionner:

  • Les grilles de notation visent à guider la notation sans contraindre les enseignants. Par conséquent, un enseignant peut effectuer les opérations suivantes lorsqu'il évalue un devoir avec une grille de notation :
    • Ignorer complètement la grille d'évaluation lors de la notation.
    • Ignorez les points d'un critère, quels que soient les points disponibles dans les niveaux du critère.
    • Sélectionnez des niveaux pour un sous-ensemble de critères uniquement.
    • Attribuez des points à un critère sans sélectionner de niveau correspondant.
    • Forcer le nombre total de points du devoir, quelle que soit la note qui serait attribuée par la grille d'évaluation.

De plus, l'API n'introduit aucune nouvelle fonctionnalité produit. En d'autres termes, l'API n'accepte pas un comportement dont l'interface utilisateur Classroom n'est pas encore associée. Par exemple, l'API ne permet pas d'imposer l'utilisation des grilles d'évaluation pour les devoirs, ni de remplacer la capacité d'un enseignant à modifier les grilles d'évaluation et les devoirs comme c'est le cas aujourd'hui.

Limites pendant la notation

De même, des limites supplémentaires s'appliquent à la modification des grilles d'évaluation une fois qu'un enseignant a commencé à l'utiliser pour la notation. Une fois la notation lancée, seules les modifications suivantes sont possibles:

  • Les modifications de texte sont autorisées pour les titres et les descriptions au niveau des critères et des niveaux.
  • L'ordre par niveau peut changer dans les critères.

Champs d'application supplémentaires

Les grilles d'évaluation peuvent être exportées manuellement vers Google Sheets pour être réutilisées par les enseignants.

Si vous créez ou mettez à jour une grille d'évaluation à partir de ces feuilles de calcul (voir un exemple dans le guide), votre application doit demander la portée https://www.googleapis.com/auth/spreadsheets.readonly ou https://www.googleapis.com/auth/spreadsheets. Sachez que les champs d'application spreadsheets sont considérés comme sensibles et que votre application peut nécessiter une validation.

Précédent
Périodes de notation