Structure des grilles d'évaluation et limites connues

Si vous ne connaissez pas les grilles d'évaluation de 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 grille d'évaluation associée à un CourseWork et cette grille est unique à ce CourseWork (elle ne peut pas être partagée entre les CourseWork ressources).
  • La grille d'évaluation est composée de critères, qui sont eux-mêmes composé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 notés (avec des points) ou non notés (sans points). Dans une grille d'évaluation, 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 notés, en particulier, doivent toujours être triés par points dans l'ordre croissant ou décroissant.
  • Une grille d'évaluation peut comporter jusqu'à 50 critères et jusqu'à 10 niveaux de performance par critère.

StudentSubmission objets sont compatibles avec les champs liés aux grilles d'évaluation :

  • En plus des propriétés draftGrade et assignedGrade existantes, un devoir rendu par un élève et noté à l'aide d'une grille d'évaluation comporte les propriétés draftRubricGrades et assignedRubricGrades. Elles représentent les notes de la grille d'évaluation (niveaux sélectionnés et valeurs de 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 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, mais cela peut entraîner un comportement qui peut être peu intuitif pour les développeurs et qui mérite d'être mentionné :

  • 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 :
    • 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 les niveaux du critère.
    • Sélectionner des niveaux pour un sous-ensemble de critères uniquement.
    • Attribuer des points à un critère sans sélectionner de niveau correspondant.
    • Remplacer le total des points du devoir, quels que soient les points provenant de 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'interface utilisateur de Classroom. Par exemple, l'API n'autorise pas l'application de grilles d'évaluation aux devoirs ni la modification de la possibilité pour un enseignant de modifier les grilles d'évaluation et les devoirs comme il le fait aujourd'hui.

Limites lors de la notation

De même, certaines limites supplémentaires s'appliquent à la modification des grilles d'évaluation une fois qu'un enseignant a commencé à les utiliser pour la notation. Seules les modifications suivantes sont possibles après le début de la notation :

  • Les modifications de texte sont autorisées pour les titres et les 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 une grille d'évaluation à partir de ces feuilles de calcul (voir un exemple dans le guide), votre application doit demander le https://www.googleapis.com/auth/spreadsheets.readonly ou https://www.googleapis.com/auth/spreadsheets champ d'application. Sachez que les spreadsheets champs d'application sont considérés comme sensibles et peuvent nécessiter la validation de votre application to be verified.

Documents de travail tiers

Les grilles d'évaluation ne peuvent être créées que par le projet Google Cloud qui a 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 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 qu'un enseignant a créé dans l'interface utilisateur de Classroom, même si cet enseignant est 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

consultez la page Fonctionnalités en preview et feuille de route.

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 :

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

Précédent
Périodes de notation