Ustalanie i aktualizowanie ocen

Ten przewodnik zawiera przykłady kodu związanego z ocenianiem w interfejsie Google Classroom API. Aby dowiedzieć się więcej o ocenianiu w Classroom, przeczytaj przewodnik po ocenach.

Ustawianie ocen za projekty uczniów

Zasób StudentSubmission ma 2 pola do przechowywania ocen: assignedGrade, czyli ocena przekazywana uczniom, oraz draftGrade, czyli ocena tymczasowa widoczna tylko dla nauczycieli. Te pola są aktualizowane za pomocą courses.courseWork.studentSubmissions.patch.

PythonJava

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()

classroom/snippets/src/main/java/PatchStudentSubmission.java

Wyświetl w GitHubie

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;

Podczas pracy z interfejsem Classroom nauczyciele nie mogą przypisać oceny, dopóki nie zapiszą oceny roboczej. Przypisaną ocenę można następnie zwrócić uczniowi. Aplikacja może ocenić projekt ucznia na 2 sposoby:

• Przypisz tylko draftGrade. Jest to przydatne na przykład wtedy, gdy nauczyciel chce sprawdzić oceny ręcznie przed ich ostatecznym zatwierdzeniem. Uczniowie nie mogą zobaczyć wersji roboczych ocen.

• Przypisz zarówno draftGrade, jak i assignedGrade, aby ocenić projekt.

Ostrzeżenie: nie ustawiaj parametru assignedGrade bez ustawienia parametru draftGrade. Ustawienie tylko parametru assignedGrade może spowodować niezamierzone wyniki w interfejsie Classroom.

Czytanie przypisanych ocen

Aby wyświetlić listę wszystkich ocen dotyczących konkretnego elementu zajęć, sprawdź obiekt odpowiedzi metody courses.courseWork.studentSubmissions.list:

PythonJava

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'))}")

classroom/snippets/src/main/java/ListStudentSubmissions.java

Wyświetl w GitHubie

  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());
  }
}

Określanie ogólnych ocen z zajęć

Interfejs Classroom API nie pozwala deweloperom odczytywać ani zapisywać ogólnej oceny z zajęć, ale można ją obliczyć programowo. Wskazówki dotyczące tego obliczenia znajdziesz w tym artykule w Centrum pomocy. Zasób Course zawiera pole gradebookSettings, które może Ci pomóc w przeprowadzaniu obliczeń.

Jeśli chcesz obliczyć ogólną ocenę, zapoznaj się z kilkoma wskazówkami dotyczącymi zarządzania pracami domowymi opóźnionymi, usprawiedliwionymi i nieoddanymi.

Zarządzanie stanem odpowiedzi uczniów

Odpowiedź ucznia może zostać wycofana, oddana lub zwrócona. Pole stanu w StudentSubmission wskazuje bieżący stan. Aby zmienić stan, użyj jednej z tych metod:

• courses.courseWork.studentSubmissions.turnIn: tylko uczeń, który jest właścicielemStudentSubmission, może go oddać.
• courses.courseWork.studentSubmissions.reclaim: tylko uczeń, który jest właścicielem StudentSubmission, może go odzyskać. Możesz odzyskać zgłoszenie tylko wtedy, gdy zostało ono już przesłane.
• courses.courseWork.studentSubmissions.return: tylko nauczyciele na zajęciach mogą zwrócić StudentSubmission. Przesłany projekt może zostać zwrócony tylko wtedy, gdy został już złożony przez ucznia.

Uwaga: wysyłanie żądań do tych punktów końcowych nie powoduje ustawienia wartości assignedGrade ani draftGrade.

Wszystkie te metody akceptują pusty parametr body, np.

PythonJava

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

classroom/snippets/src/main/java/ReturnStudentSubmission.java

Wyświetl w GitHubie

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;
}

Załączniki dodatku do oceniania

Jeśli jesteś deweloperem dodatków do Classroom, możesz ustawiać oceny dla poszczególnych załączników dodatku i skonfigurować ocenę tak, aby była widoczna dla nauczycieli podczas sprawdzania prac uczniów. Więcej informacji znajdziesz w instrukcjach dotyczących załączników typu Aktywność i przekazywania ocen.