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 à cetCourseWork
(elle n'est pas partageable entre les ressourcesCourseWork
). - 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.
Champs des devoirs rendus par les élèves associés
Les objets StudentSubmission
acceptent les champs liés aux grilles d'évaluation:
- En plus des propriétés
draftGrade
etassignedGrade
existantes, un devoir d'élève noté avec une grille d'évaluation comporte des propriétésdraftRubricGrades
etassignedRubricGrades
. 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 à l'aide d'une grille d'évaluation :
- 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 lors de 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 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.
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:
- L'utilisateur qui envoie la demande dispose d'une licence Google Workspace for Education Plus.
- Le propriétaire du cours correspondant dispose d'une licence Google Workspace for Education Plus.
Consultez la page sur l'é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 et de le demander pour le développement.