Method: courses.courseWork.studentSubmissions.patch

Aktualisiert ein oder mehrere Felder einer von einem Schüler oder Studenten eingereichten Aufgabe.

Unter google.classroom.v1.StudentSubmission finden Sie Details dazu, welche Felder aktualisiert werden können und wer sie ändern darf.

Diese Anfrage muss vom Developer Console-Projekt der OAuth-Client-ID gestellt werden, die zum Erstellen des entsprechenden Kursmaterials oder eines Add-on-Anhangs verwendet wurde, bei dem die Notensynchronisierung für das entsprechende Kursmaterial aktiviert ist.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED wenn das anfragende Entwicklerprojekt das entsprechende Kursmaterial oder einen Add-on-Anhang für das entsprechende Kursmaterial mit aktivierter Notensynchronisierung nicht erstellt hat, wenn der Nutzer die angeforderte Änderung an der von einem Schüler oder Studenten eingereichten Aufgabe nicht vornehmen darf oder bei Zugriffsfehlern.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • NOT_FOUND, wenn der angeforderte Kurs, das Kursmaterial oder die von einem Schüler oder Studenten eingereichte Aufgabe nicht vorhanden ist.

HTTP-Anfrage

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

ID des Kurses. Diese ID kann entweder die von Classroom zugewiesene ID oder ein alias sein.
courseWorkId

string

ID des Kursmaterials.
id

string

ID der von einem Schüler oder Studenten eingereichten Aufgabe.

Suchparameter

Parameter
updateMask

string (FieldMask format)

Maske, die angibt, welche Felder der von einem Schüler oder Studenten eingereichten Aufgabe aktualisiert werden sollen. Dieses Feld ist für eine Aktualisierung erforderlich. Die Aktualisierung schlägt fehl, wenn ungültige Felder angegeben werden.

Lehrkräfte können die folgenden Felder angeben:

  • draftGrade
  • assignedGrade

Dies ist eine durch Kommas getrennte Liste voll qualifizierter Feldnamen. Beispiel: "user.displayName,photo".
previewVersion

enum (PreviewVersion)

Optional. Die Preview-Version der API. Diese Version muss festgelegt werden, um auf neue API-Funktionen zuzugreifen, die Entwicklern im Vorschauprogramm zur Verfügung stehen.

Anfragetext

Der Anfragetext enthält eine Instanz von StudentSubmission.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von StudentSubmission.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/classroom.coursework.students
  • https://www.googleapis.com/auth/classroom.coursework.me

Weitere Informationen finden Sie im Autorisierungsleitfaden.