Notes

Ce document présente les concepts de notation pertinents pour l'API Classroom.

Consultez l'article Noter et suivre les devoirs pour en savoir plus sur les parcours de notation des enseignants dans l'application Google Classroom.

CourseWork et StudentSubmissions

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

Pour les devoirs notés, les enseignants attribuent une note draftGrade sur la page StudentSubmission avant de les rendre aux élèves. Lorsque le devoir est renvoyé dans l'application Classroom, un assignedGrade est automatiquement défini sur le StudentSubmission, avec la même valeur que le draftGrade actuel. Les développeurs peuvent définir ces deux champs et doivent imiter 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. Consultez Créer et gérer des notes pour obtenir des exemples de code permettant de lire, de définir et de renvoyer des notes.

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

Devoirs en retard, excusés et manquants

Lorsque des éléments CourseWork sont attribués, des espaces réservés StudentSubmissions sont créés pour chaque élève, même s'il n'a pas interagi avec le devoir correspondant. Les enseignants peuvent définir une dueDate sur la page CourseWork. Les StudentSubmissions associés sont marqués d'un champ late (défini sur true) si l'élève ne remet pas le devoir avant la date limite. Les enseignants peuvent également désactiver la remise tardive de devoirs à l'aide d'un paramètre de l'application Classroom.

De plus, les StudentSubmissions non remis avant le dueDate sont annotés comme manquants 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 un draftGrade, que l'enseignant peut personnaliser, mais qui est défini sur 0 par défaut.

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és comme terminés 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 dans les périodes de notation.

Remarque : Les états "Terminé", "Manquant" et "Excusé" de StudentSubmissions ne sont pas clairement identifiables dans l'API. Si ce comportement affecte votre application, laissez un commentaire dans ce problème en décrivant l'impact sur votre cas d'utilisation.

Consultez l'article d'aide Noter et rendre un devoir pour savoir comment les enseignants peuvent gérer les devoirs remis.

Note globale et systèmes de notation

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

Pour en savoir plus sur les différents systèmes de notation et obtenir des exemples, consultez l'article Configurer la notation.

Voici quelques points clés :

• La ressource Course comporte un objet gradebookSettings contenant des informations sur les paramètres de notes 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 option 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 leurs noms à afficher, leur pourcentage de pondération et les points par défaut pour les 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 est absente. Par exemple, si les pondérations des catégories étaient de 20 % pour les devoirs, 10 % pour les exercices et 70 % pour les quiz, mais qu'aucun exercice n'était réellement 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 prévoyez de refléter les notes globales de Classroom dans votre application, vous devrez faire de même.

Périodes de notation

Les enseignants peuvent regrouper les devoirs CourseWork d'un cours dans des plages de dates distinctes appelées périodes de notation. Les périodes de notation peuvent être utilisées pour filtrer les devoirs dans la vue du carnet de notes et créer des catégories distinctes 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 n'inclurait que les devoirs StudentSubmissions à rendre pendant cette période.

Le système de notation défini pour le cours s'applique aux périodes de notation. Ainsi, si les périodes de notation d'automne et de printemps 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.
• Note globale de tous les devoirs de la période de printemps.
• Note globale de tous les devoirs de la période de l'automne.

Dans les trois cas, la note globale sera calculée à l'aide de catégories pondérées.

Pour obtenir une présentation de la fonctionnalité, consultez l'annonce sur les périodes de notation.

Les périodes de notation s'étendent CourseWork avec un gradingPeriodId qui identifie la période de notation dans laquelle s'inscrit le devoir.

Consultez le guide de l'API avec périodes de notation pour savoir comment 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 CourseWork, et utiliser ces rubriques comme guide pour noter les StudentSubmissions correspondants.

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

Les rubriques étendent la ressource StudentSubmissions avec des champs supplémentaires :

• rubricId identifie la grille d'évaluation qui correspond à la CourseWork de la soumission.
• draftRubricGrades représente les critères et les notes provisoires 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 rubriques et lire les notes associées avec l'API.

Échelles de notation

Classroom est compatible avec les barèmes de notation personnalisables. Par exemple, les enseignants peuvent traduire les notes numériques en notes alphabétiques. Ces paramètres et les données correspondantes ne sont pas disponibles dans l'API.