Définir et mettre à jour les notes

Ce guide fournit des exemples de code liés à la notation pour l'API Classroom. Ce document se concentre sur le parcours de notation de base dans Classroom: la gestion des états et des notes StudentSubmission.

Consultez le guide sur les notes pour vous familiariser avec les concepts de notation dans Classroom.

Gérer les états des devoirs des élèves

StudentSubmission peut être annulé, rendu ou renvoyé. Le champ state indique l'état actuel. La notation est généralement effectuée une fois que StudentSubmission est dans l'état TURNED_IN.

Pour modifier l'état à l'aide de l'API Classroom, appelez l'une des méthodes suivantes:

Toutes ces méthodes acceptent un paramètre body vide, comme illustré dans l'exemple suivant:

Python

service.courses().courseWork().studentSubmission().turnIn(
    courseId=course_id,
    courseWorkId=coursework_id,
    id=studentsubmission_id,
    body={}).execute()

Java

classroom/snippets/src/main/java/ReturnStudentSubmission.java
try {
  service
      .courses()
      .courseWork()
      .studentSubmissions()
      .classroomReturn(courseId, courseWorkId, id, null)
      .execute();
} catch (GoogleJsonResponseException e) {
  // TODO (developer) - handle error appropriately
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf(
        "The courseId (%s), courseWorkId (%s), or studentSubmissionId (%s) does "
            + "not exist.\n",
        courseId, courseWorkId, id);
  } else {
    throw e;
  }
} catch (Exception e) {
  throw e;
}

Définir des notes pour les devoirs des élèves

La ressource StudentSubmission comporte deux champs pour stocker la note globale pour le travail noté CourseWork:

  • draftGrade est une note provisoire visible uniquement par les enseignants.
  • assignedGrade correspond à la note envoyée aux élèves.

Ces champs sont mis à jour à l'aide de courses.courseWork.studentSubmissions.patch, comme illustré dans l'exemple suivant:

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

classroom/snippets/src/main/java/PatchStudentSubmission.java
StudentSubmission studentSubmission = null;
try {
  // Updating the draftGrade and assignedGrade fields for the specific student submission.
  StudentSubmission content =
      service
          .courses()
          .courseWork()
          .studentSubmissions()
          .get(courseId, courseWorkId, id)
          .execute();
  content.setAssignedGrade(90.00);
  content.setDraftGrade(80.00);

  // The updated studentSubmission object is returned with the new draftGrade and assignedGrade.
  studentSubmission =
      service
          .courses()
          .courseWork()
          .studentSubmissions()
          .patch(courseId, courseWorkId, id, content)
          .set("updateMask", "draftGrade,assignedGrade")
          .execute();

  /* Prints the updated student submission. */
  System.out.printf(
      "Updated student submission draft grade (%s) and assigned grade (%s).\n",
      studentSubmission.getDraftGrade(), studentSubmission.getAssignedGrade());
} catch (GoogleJsonResponseException e) {
  // TODO (developer) - handle error appropriately
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf(
        "The courseId (%s), courseWorkId (%s), or studentSubmissionId (%s) does "
            + "not exist.\n",
        courseId, courseWorkId, id);
  } else {
    throw e;
  }
} catch (Exception e) {
  throw e;
}
return studentSubmission;

Lorsque vous utilisez l'interface utilisateur de Classroom, vous ne pouvez pas définir une assignedGrade tant que vous n'avez pas enregistré une draftGrade. Le assignedGrade peut ensuite être renvoyé à 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 d'examiner manuellement les notes avant de les finaliser. Les élèves ne peuvent pas voir les notes provisoires.

  • Attribuez à la fois draftGrade et assignedGrade pour noter entièrement un devoir.

Utilisez l'argument updateMask pour configurer le champ à définir.

Consultez Ajouter des pièces jointes à une réponse d'élève pour comprendre les champs d'application et les autorisations requis pour modifier StudentSubmissions.

Lire les notes attribuées

Vous pouvez accéder à toutes les notes d'un CourseWork particulier à l'aide de la méthode courses.courseWork.studentSubmissions.list pour récupérer tous les StudentSubmissions correspondants et inspecter les champs assignedGrade et draftGrade appropriés:

Python

response = coursework.studentSubmissions().list(
    courseId=course_id,
    courseWorkId=coursework_id,
    # optionally include `pageSize` to restrict the number of student
    # submissions included in the response.
    pageSize=10
).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

classroom/snippets/src/main/java/ListStudentSubmissions.java
  ListStudentSubmissionsResponse response =
      service
          .courses()
          .courseWork()
          .studentSubmissions()
          .list(courseId, courseWorkId)
          .setPageToken(pageToken)
          .execute();

  /* Ensure that the response is not null before retrieving data from it to avoid errors. */
  if (response.getStudentSubmissions() != null) {
    studentSubmissions.addAll(response.getStudentSubmissions());
    pageToken = response.getNextPageToken();
  }
} while (pageToken != null);

if (studentSubmissions.isEmpty()) {
  System.out.println("No student submissions found.");
} else {
  for (StudentSubmission submission : studentSubmissions) {
    System.out.printf(
        "User ID %s, Assigned grade: %s\n",
        submission.getUserId(), submission.getAssignedGrade());
  }
}

Consultez Récupérer les réponses des élèves pour comprendre les champs d'application et les autorisations requises pour lire StudentSubmissions.

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. Si vous souhaitez calculer la note globale, consultez le guide des notes pour comprendre des concepts importants tels que les CourseWork, les périodes de notation et les différents systèmes de notation.

Noter les pièces jointes de modules complémentaires

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.

Notes des grilles d'évaluation

StudentSubmissions comporte des champs qui représentent les scores attribués en fonction de Rubrics:

  • draftRubricGrade est un ensemble provisoire de notes Criterion visibles uniquement par les enseignants.
  • assignedRubricGrade correspond à l'ensemble des scores Criterion communiqués aux élèves.

Vous ne pouvez pas définir de notes de grille d'évaluation à l'aide de l'API Google Classroom, mais vous pouvez les lire. Pour en savoir plus, consultez le guide des grilles d'évaluation et les limites.

Suivant
Périodes de notation