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 sur la façon de noter avec une grille d'évaluation dans l'interface utilisateur de Classroom.

Structure des grilles d'évaluation

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

  • Il existe (au maximum) une seule rubrique associée à un CourseWork, et cette rubrique est propre à ce CourseWork (elle ne peut pas être partagée entre les ressources CourseWork).
  • La grille d'évaluation se compose de critères, qui se composent de niveaux. Un barème 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 notés (sans points). Dans un barème, les niveaux doivent être entièrement notés ou entièrement non notés.
    • Si les niveaux sont notés, tous les niveaux d'un critère doivent avoir une valeur de points unique. Les points peuvent être des nombres entiers (comme 10) ou des valeurs à virgule flottante (comme 9,99). Cela peut inclure 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 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 important et reflète l'ordre dans lequel ils sont représentés dans l'interface utilisateur de Classroom.
    • Les niveaux avec score, en particulier, 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 rubriques :

  • En plus des propriétés draftGrade et assignedGrade existantes, un devoir d'élève noté avec un barème comporte les propriétés draftRubricGrades et assignedRubricGrades. Elles 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 d'évaluation, respectivement dans les états "Brouillon" et "Attribué".
  • 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'interface utilisateur de Classroom chaque fois que cela est possible pour assurer la cohérence. Toutefois, cela peut entraîner un comportement qui peut être peu intuitif pour les développeurs et qu'il convient de mentionner :

  • Les grilles d'évaluation sont destinées à 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 :
    • Ignorez complètement la grille d'évaluation lors de la notation.
    • Remplacez 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.
    • Attribuer des points à un critère sans sélectionner le niveau correspondant.
    • Remplace le nombre total de points du devoir, quels que soient les points obtenus grâce à la grille d'évaluation.

De plus, l'API n'est pas compatible avec les comportements qui ne sont pas déjà présents dans l'UI Classroom. Par exemple, l'API ne permet pas d'appliquer l'utilisation de rubriques dans les devoirs ni de remplacer la capacité d'un enseignant à modifier les rubriques et les devoirs comme il peut le faire 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é à les utiliser pour évaluer des devoirs. Une fois la notation commencée, vous ne pouvez effectuer que les modifications suivantes :

  • Vous pouvez modifier le texte des titres et des 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 Google Sheets pour être réutilisées par les enseignants.

Si vous créez ou mettez à jour un barème à partir de ces feuilles de calcul (consultez 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 niveaux d'accès spreadsheets sont considérés comme sensibles et peuvent nécessiter la validation de votre application.

Cours tiers

Seul le projet Google Cloud qui a créé l'élément CourseWork parent peut créer des rubriques. 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 les ressources qui ne leur appartiennent pas.

Cela s'étend 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 utilisateur Classroom, même si cet enseignant est propriétaire de l'application. Si cela limite considérablement votre cas d'utilisation, envoyez vos commentaires dans l'outil public de suivi des problèmes.

Exigences concernant les licences

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

Consultez la section Éligibilité des utilisateurs pour en savoir plus sur la façon dont les fonctionnalités de l'API sont proposées aux utilisateurs. Consultez également les conditions préalables de l'API Classroom pour vous familiariser avec les comptes de démonstration pour le développement et en demander un.

Précédent
Périodes de notation