Ce guide fournit des exemples de code liés à la notation pour l'API Google Classroom. Consultez le guide sur les notes pour vous familiariser avec les concepts de notation dans Classroom.
Définir des notes pour les devoirs des élèves
La ressource StudentSubmission comporte deux champs pour stocker les notes : assignedGrade, qui correspond à la note communiquée aux élèves, et draftGrade, qui est une note provisoire visible uniquement par les enseignants. Ces champs sont mis à jour à l'aide de courses.courseWork.studentSubmissions.patch.
Python
studentSubmission = {
'assignedGrade': 99,
'draftGrade': 80
}
service.courses().courseWork().studentSubmissions().patch(
courseId=course_id,
courseWorkId=coursework_id,
id=studentsubmission_id,
updateMask='assignedGrade,draftGrade',
body=studentSubmission).execute()
Java
Lorsque vous utilisez l'interface utilisateur de Classroom, vous ne pouvez pas attribuer une note tant que vous n'avez pas enregistré une note provisoire. La note attribuée peut ensuite être renvoyée à un élève. Votre application peut noter le devoir d'un élève de deux manières:
Attribuez uniquement le
draftGrade. Cela permet, par exemple, à l'enseignant de vérifier manuellement les notes avant de les finaliser. Les élèves ne peuvent pas voir les notes provisoires.Attribuez à la fois
draftGradeetassignedGradepour noter entièrement un devoir.
Lire les notes attribuées
Vous pouvez lister toutes les notes d'un élément de cours spécifique en explorant l'objet de réponse de la méthode courses.courseWork.studentSubmissions.list:
Python
response = coursework.studentSubmissions().list(
courseId=course_id,
courseWorkId=coursework_id,
pageSize=10 # optionally include `pageSize` to restrict the number of student submissions included in the response.
).execute()
submissions.extend(response.get('studentSubmissions', []))
if not submissions:
print('No student submissions found.')
print('Student Submissions:')
for submission in submissions:
print(f"Submitted at:"
f"{(submission.get('userId'), submission.get('assignedGrade'))}")
Java
Déterminer les notes globales du cours
L'API Classroom ne permet pas aux développeurs de lire ni d'écrire la note globale du cours, mais vous pouvez la calculer de manière programmatique. Consultez l'article du Centre d'aide sur la configuration de la notation pour obtenir des conseils sur ce calcul. La ressource Course inclut le champ gradebookSettings qui peut vous aider à effectuer les calculs.
Si vous souhaitez calculer la note globale, consultez quelques conseils à prendre en compte lorsque vous gérez les devoirs tardifs, justifiés et manquants.
Gérer l'état des réponses des élèves
Une réponse d'élève peut être annulée, remise ou rendue. Le champ d'état dans StudentSubmission indique l'état actuel. Pour modifier l'état, appelez l'une des méthodes suivantes:
courses.courseWork.studentSubmissions.turnIn: seul l'élève propriétaire d'unStudentSubmissionpeut le rendre.courses.courseWork.studentSubmissions.reclaim: Seul l'élève propriétaire d'unStudentSubmissionpeut le récupérer. Vous ne pouvez récupérer le contenu que s'il a déjà été envoyé.courses.courseWork.studentSubmissions.return: seuls les enseignants du cours peuvent renvoyer unStudentSubmission. Le devoir ne peut être rendu que si l'élève l'a déjà rendu.
Toutes ces méthodes acceptent un paramètre body vide, par exemple:
Python
service.courses().courseWork().studentSubmission().turnIn(
courseId=course_id,
courseWorkId=coursework_id,
id=studentsubmission_id,
body={}).execute()
Java
Pièces jointes du module complémentaire de notation
Si vous êtes développeur de modules complémentaires Classroom, vous pouvez définir des notes pour les pièces jointes de modules complémentaires individuelles et configurer la note pour qu'elle soit visible par les enseignants lorsqu'ils examinent le travail des élèves. Pour en savoir plus, consultez les tutoriels sur les pièces jointes de type activité et sur le transfert de notes.