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 notés, une valeur de points unique doit être définie pour tous les niveaux d'un critère. Les points peuvent être des entiers (comme 10) ou des valeurs à virgule flottante (comme 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 de 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 StudentSubmission acceptent les champs liés aux grilles d'évaluation:

  • 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. Ils représentent les notes de la grille d'évaluation (niveaux sélectionnés et valeurs en points) que l'élève reçoit lors de la notation à partir de la grille, dans les états "Brouillon" et "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.

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 le 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'est pas compatible avec le comportement que l'interface utilisateur de Classroom n'a pas encore. Par exemple, l'API n'autorise pas l'application de grilles d'évaluation aux devoirs ni le forçage de la possibilité pour un enseignant de modifier les grilles d'évaluation et les devoirs, comme c'est le cas aujourd'hui.

Limites pendant la notation

De même, des restrictions supplémentaires s'appliquent à la modification des grilles d'évaluation une fois qu'un enseignant a commencé à les utiliser pour noter ses élèves. Une fois la notation lancée, 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 en fonction des 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 modifiez 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.

Cours tiers

Les grilles d'évaluation ne peuvent être créées que par le projet Google Cloud ayant créé l'élément CourseWork parent. Il s'agit d'un modèle de conception plus large dans l'API Classroom, qui empêche différentes applications d'avoir un impact sur des ressources qui ne sont pas les leurs.

Cela s'applique également aux ressources créées par les utilisateurs dans l'application Classroom. Par exemple, une application ne peut pas gérer les grilles d'évaluation d'un devoir créé par un enseignant dans l'interface Classroom, même si cet enseignant est le propriétaire de l'application. Si cela limite considérablement votre cas d'utilisation, partagez vos commentaires dans l'outil public de suivi des problèmes.

Exigences concernant les licences

Un utilisateur ne peut créer, mettre à jour et supprimer des grilles d'évaluation avec l'API Classroom que si les conditions suivantes sont remplies:

Consultez la page Éligibilité des utilisateurs pour en savoir plus sur la façon dont les fonctionnalités de l'API sont exposées aux utilisateurs et sur les prérequis de l'API Classroom afin de vous familiariser avec un compte de démonstration pour le développement et de le demander.

Précédent
Périodes de notation