Notes

Ce document présente les concepts de notation liés à l'API Classroom.

Consultez l'article Noter et suivre les devoirs pour découvrir les parcours de notation des enseignants dans l'application Google Classroom.

Travaux et devoirs

Dans Google Classroom, les élèves rendent StudentSubmissions pour les CourseWork devoirs figurant dans leur Course. CourseWork peut être noté ou non. Si un CourseWork est noté, il a une valeur maxPoints qui représente le nombre total de points que vaut le devoir. Si maxPoints est nul ou non spécifié, le devoir n'est pas noté.

Pour les devoirs notés, les enseignants attribuent une note draftGrade au StudentSubmission avant de le rendre à l'élève. Lorsque l'envoi est renvoyé dans l'application Classroom, un assignedGrade est automatiquement défini sur le StudentSubmission, avec la même valeur que l'draftGrade actuelle. Les développeurs peuvent définir ces deux champs et doivent émuler le comportement de l'application Classroom. Par exemple, un assignedGrade ne peut pas être défini sans draftGrade. Les deux champs sont représentés par des nombres décimaux. S'ils ne sont pas définis, cela signifie que l'enseignant n'a pas encore attribué la note correspondante. Pour obtenir des exemples de code permettant de lire, de définir et de renvoyer des notes, consultez Créer et gérer des notes.

Les élèves peuvent envoyer plusieurs devoirs pour le même devoir CourseWork. L'état de remise et l'historique des notes sont suivis dans StudentSubmission.submissionHistory.

Devoirs en retard, justifiés et manquants

Lorsque des éléments CourseWork sont attribués, un espace réservé StudentSubmissions est créé pour chaque élève, même s'il n'a pas interagi avec le devoir correspondant. Les enseignants peuvent définir un dueDate sur le CourseWork, et les StudentSubmissions associés sont marqués d'un champ late (défini sur true) si l'élève ne rend pas le devoir avant la date prévue. Les enseignants peuvent également désactiver les remises en retard à l'aide d'un paramètre de l'application Classroom.

De plus, les StudentSubmissions qui ne sont pas envoyés avant le dueDate sont annotés comme manquant dans le carnet de notes Classroom. Les enseignants peuvent également marquer manuellement les devoirs comme manquants dans l'application Classroom. Les devoirs manquants reçoivent automatiquement une note draftGrade, qui peut être personnalisée par l'enseignant, mais qui est définie par défaut sur 0.

Les devoirs manquants peuvent être marqués comme terminés ou excusés par l'enseignant. Le champ draftGrade par défaut des StudentSubmissions marquées comme terminées est supprimé jusqu'à ce que l'enseignant en définisse un nouveau manuellement. Les StudentSubmissions marqués comme dispensés ne sont pas pris en compte dans le calcul de la note globale, y compris pour les périodes de notation.

Consultez l'article d'aide Noter et rendre un devoir pour en savoir plus sur la gestion des devoirs par les enseignants.

Note globale et systèmes de notation

Classroom est compatible avec plusieurs systèmes de notation pour calculer les notes globales des élèves pendant le cours. Les notes globales peuvent être calculées directement à partir du total des points, pondérées par catégorie ou pas du tout.

Consultez l'article Configurer la notation pour en savoir plus sur les différents systèmes de notation et voir des exemples.

Voici quelques points importants:

• La ressource Course comporte un objet gradebookSettings contenant des informations sur les paramètres de note du cours.
  • calculationType spécifie la méthode de calcul du cours.
  • displaySettings spécifie qui peut voir les notes globales dans l'application Classroom. Il est recommandé de respecter cette règle dans votre propre application lorsque cela est possible. Par exemple, si les élèves ne peuvent pas voir leur note globale dans Classroom, ne la leur montrez pas dans votre application.
  • gradeCategories contient la liste des catégories de notes configurées pour le cours, y compris leur nom à afficher, leur pourcentage de pondération et les points par défaut des devoirs correspondants.
• Si un cours utilise la notation pondérée, vous devrez peut-être normaliser les pondérations dans les cas où une catégorie n'est pas présente. Par exemple, si les pondérations des catégories étaient de 20% pour les devoirs, de 10% pour les exercices guidés et de 70% pour les quiz, mais qu'aucun exercice guidé n'était présent, Classroom ajuste les pondérations à environ 22% pour les devoirs et à environ 78 % pour les quiz lors du calcul des notes globales. Si vous souhaitez refléter les notes globales de Classroom dans votre application, vous devez faire de même.

Périodes de notation

Les enseignants peuvent regrouper les devoirs CourseWork d'un cours en plages de dates distinctes appelées périodes de notation. Les périodes de notation peuvent être utilisées pour filtrer les travaux dans la vue du carnet de notes et créer des groupes distincts pour le calcul des notes globales.

Par exemple, un enseignant peut créer des périodes de notation pour les semestres de printemps et d'automne. La note globale pour la période du printemps ne comprendra que les StudentSubmissions à rendre pendant la période du printemps.

Le système de notation défini pour le cours s'applique aux périodes de notation. Par conséquent, si les périodes de notation du printemps et de l'automne mentionnées ci-dessus étaient définies pour un cours utilisant des catégories de notation pondérées, il y aurait finalement trois ensembles de notes globales pour les élèves:

• Note globale pour tous les devoirs du cours.
• La note globale pour tous les devoirs de la période du printemps.
• Note globale pour tous les devoirs de la plage de dates d'automne.

Tous les trois calculeraient la note globale en fonction des catégories pondérées.

Pour en savoir plus sur cette fonctionnalité, consultez l'annonce sur les périodes de notation.

Les périodes de notation étendent CourseWork avec un gradingPeriodId qui identifie la période de notation à laquelle appartient le devoir.

Consultez le guide de l'API sur les périodes de notation pour apprendre à lire et à gérer les périodes de notation avec l'API.

Grilles d'évaluation

Les enseignants peuvent créer et associer des Rubrics à des devoirs CourseWork, et utiliser ces grilles comme guide lors de la notation des StudentSubmissions correspondantes.

Consultez l'article sur les grilles d'évaluation pour découvrir comment les enseignants peuvent les utiliser dans Classroom.

Les grilles d'évaluation étendent la ressource StudentSubmissions avec des champs supplémentaires:

• rubricId identifie la grille d'évaluation qui correspond à l'CourseWork de l'envoi.
• draftRubricGrades représente les critères et les scores d'espace réservé que l'enseignant a rédigés avant de renvoyer le devoir à l'élève.
• assignedRubricGrades représente les critères et les notes que l'élève reçoit une fois que l'enseignant a rendu le devoir.

Consultez le guide de l'API Rubrics pour savoir comment gérer les grilles d'évaluation et lire les notes associées à l'aide de l'API.

Échelles de notation

Classroom est compatible avec des échelles de notation personnalisables, qui permettent par exemple aux enseignants de convertir des notes numériques en notes alphabétiques. Ces paramètres et les données correspondantes ne sont pas disponibles dans l'API.