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 d'évaluation et la notation par grille d'évaluation dans l'interface utilisateur de Classroom.

Structure des grilles d'évaluation

Il peut être intéressant de souligner certains concepts importants lorsque vous utilisez l'API pour interagir avec les grilles d'évaluation:

  • Une seule grille d'évaluation est associée (au maximum) à un élément CourseWork, qui est propre à cet élément CourseWork (elle ne peut pas être partagée entre les ressources CourseWork).
  • La grille d'évaluation est constituée de critères, lesquels sont constitués 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 marqués (points) ou non (aucun point). Dans une grille d'évaluation, les niveaux doivent avoir été intégralement notés ou non notés.
    • Si les niveaux sont notés, un nombre de points unique doit être défini pour tous les niveaux d'un critère. Les points peuvent être des entiers (comme 10) ou des valeurs à virgule flottante (comme 9,99). Il peut y en avoir 0. Les valeurs nulles ne sont pas acceptées. De plus, une grille d'évaluation ne peut pas comporter un seul critère avec un seul niveau représentant 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 significatif et reflète l'ordre dans lequel ils sont représentés dans l'interface utilisateur Classroom.
    • Les niveaux notés en particulier doivent toujours être triés par points, dans l'ordre croissant ou décroissant.
  • Il peut y avoir jusqu'à 50 critères par grille d'évaluation et jusqu'à 10 niveaux de performance par critère.

Les objets concernant les envois d'élèves changent également:

  • En plus des propriétés draftGrade et assignedGrade existantes, le devoir d'un élève noté avec une grille d'évaluation possède les propriétés draftRubricGrades et assignedRubricGrades. Ceux-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 d'évaluation, respectivement à l'état de brouillon et à l'état attribué.
  • Pour l'instant, ces propriétés sont en lecture seule. Cela signifie que l'API ne peut pas être utilisée pour noter les devoirs, mais vous pouvez lire les devoirs notés dans l'interface utilisateur de Classroom.
  • Les devoirs des élèves associés à une grille d'évaluation contiennent un champ rubricId. Ce champ représente la dernière grille d'évaluation associée à la CourseWork. Cette valeur peut changer si les enseignants suppriment et recréent une grille d'évaluation.

Comportements des grilles d'évaluation

L'API vise à reproduire l'interface utilisateur de Classroom autant que possible pour plus de cohérence, mais cela peut entraîner un comportement qui peut être peu intuitif pour les développeurs et mérite d'être mentionné:

  • Les grilles d'évaluation ont pour but de guider la notation sans contraindre les enseignants. Par conséquent, un enseignant peut effectuer les opérations suivantes lorsqu'il note un devoir à l'aide d'une grille d'évaluation :
    • Ignorer complètement la grille d'évaluation lors de la notation.
    • Remplacer les points d'un critère, quels que soient les points disponibles dans ses niveaux.
    • Sélectionnez des niveaux pour un sous-ensemble de critères uniquement.
    • Attribuez des points à un critère sans sélectionner de niveau correspondant.
    • Remplacez le nombre total de points du devoir, quels que soient les points qui proviendraient de la grille d'évaluation.

De plus, l'API n'introduit aucune nouvelle fonctionnalité produit. En d'autres termes, l'API n'est pas compatible avec un comportement dont l'interface utilisateur Classroom n'a pas encore accès. Par exemple, l'API ne permet pas d'appliquer des grilles d'évaluation aux devoirs ni d'ignorer la capacité d'un enseignant à modifier les grilles d'évaluation et les devoirs comme c'est le cas aujourd'hui.

Limites lors de la notation

De même, la modification des grilles d'évaluation présente des limites supplémentaires lorsqu'un enseignant commence à l'utiliser pour la notation. Une fois que l'évaluation a commencé, seules les modifications suivantes sont possibles:

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

Champs d'application supplémentaires

Les grilles d'évaluation peuvent être exportées manuellement vers des feuilles de calcul Google afin que les enseignants puissent les réutiliser.

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 le champ d'application https://www.googleapis.com/auth/spreadsheets.readonly ou https://www.googleapis.com/auth/spreadsheets. Sachez que les champs d'application de spreadsheets sont considérés comme sensibles et peuvent nécessiter la validation de votre application.