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 temporaires.Attribuez à la fois
draftGrade
etassignedGrade
pour 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 par programmation. Consultez l'article du Centre d'aide sur la configuration des notes 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'unStudentSubmission
peut le rendre.courses.courseWork.studentSubmissions.reclaim
: Seul l'élève propriétaire d'unStudentSubmission
peut 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 des modules complémentaires 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.