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 la structure générale d'une grille d'évaluation et la méthode de notation par grille l'UI de Classroom.

Structure des grilles d'évaluation

Certains concepts importants méritent d'être soulignés lorsque vous utilisez la API permettant d'interagir avec les grilles d'évaluation:

  • Il n'y a (au maximum) qu'une seule grille d'évaluation associée à une CourseWork. cette grille d'évaluation est propre à CourseWork (elle n'est pas partageable CourseWork ressources).
  • Elle comprend des critères, qui sont composés de niveaux. Une grille d'évaluation doit avoir toujours au moins un critère, et un critère doit toujours avoir au moins à un niveau.
  • Les niveaux peuvent être notés (points) ou non notés (pas de points). Les niveaux doivent être entièrement notées ou non notées dans une grille d’évaluation.
    • Si les niveaux sont évalués, tous les niveaux d'un critère doivent avoir un barème de notation défini. Les points peuvent être des nombres entiers (comme 10) ou des valeurs à virgule flottante (comme 9,99). Il peut s'agir de 0. Les valeurs nulles ne sont pas acceptées. En outre, une grille d'évaluation ne peut pas comporter un seul critère à un seul niveau. soit 0 point.
    • Si les niveaux ne sont pas notés, le champ "points" doit être omis. nul 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'UI de Classroom.
    • Les niveaux notés en particulier doivent toujours être triés par points dans un 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 Contribution des é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 contient draftRubricGrades et assignedRubricGrades. Celles-ci représentent les notes de la grille d'évaluation (niveaux et le barème de notation) que l'élève reçoit lors de la notation du d'évaluation, respectivement à l'état "Brouillon" et à l'état attribué.
  • Pour l'instant, ces propriétés sont en lecture seule. Cela signifie que l'API ne peut pas pour noter les devoirs rendus, mais vous pouvez consulter les devoirs notés dans le Interface utilisateur de Classroom.
  • Les devoirs remis par les élèves associés à une grille d'évaluation contiennent un champ rubricId. Ce champ représente la dernière grille d'évaluation associée au 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 dans un souci de cohérence dans la mesure du possible, mais cela peut entraîner un comportement peu intuitif pour les développeurs et qui vaut la peine mentionnant:

  • Elles ont pour but de guider la notation sans contraindre les enseignants. En tant que Résultat, l'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 pour un critère, indépendamment des points disponibles aux 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 de niveau correspondant.
    • Remplace le total de points du devoir, quels que soient les points proviendrait de la grille d’évaluation.

De plus, l'API n'introduit aucune nouvelle fonctionnalité produit. Dans d'autres l'API n'est pas compatible avec un comportement dont l'interface utilisateur de Classroom n'est pas encore compatible. Par exemple, l'API ne permet pas d'imposer l'utilisation de grilles d'évaluation pour les devoirs ne pas autoriser les enseignants à modifier les grilles d'évaluation et les devoirs ; dès aujourd'hui.

Limites lors de la notation

De même, la modification d'une grille d'évaluation est soumise à des restrictions supplémentaires l'enseignant a commencé à noter les devoirs avec. Seules les modifications suivantes sont possibles après de la notation au début:

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

Champs d'application supplémentaires

Vous pouvez exporter manuellement les grilles d'évaluation vers des feuilles de calcul Google afin de les réutiliser les enseignants.

Si vous créez ou mettez à jour une grille d'évaluation à partir de ces feuilles de calcul (voir un exemple dans la ), votre application doit demander le https://www.googleapis.com/auth/spreadsheets.readonly ou Champ d'application de https://www.googleapis.com/auth/spreadsheets. Notez que les spreadsheets habilitations sont considérées comme sensibles et peuvent nécessiter votre application à valider.