Method: courses.courseWork.studentSubmissions.patch

Aktualisiert ein oder mehrere Felder einer Schüler-/Studenteneinreichung.

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

Diese Anfrage muss über das Developer Console-Projekt der OAuth-Client-ID erfolgen, die zum Erstellen des entsprechenden Kurselements verwendet wurde.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn die entsprechende Kursarbeit nicht vom anfragenden Entwicklerprojekt erstellt wurde, wenn der Nutzer nicht berechtigt ist, die angeforderte Änderung an der Einreichung des Schülers oder Studenten vorzunehmen, oder bei Zugriffsfehlern.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • NOT_FOUND, wenn der angeforderte Kurs, die angeforderte Kursarbeit oder die angeforderte Einreichung eines Schülers oder Studenten 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

Kennung des Kurses. Diese Kennung kann entweder die in Classroom zugewiesene Kennung oder eine alias sein.
courseWorkId

string

Kennung der Kursarbeit.
id

string

Kennung der Aufgabe des Schülers oder Studenten.

Abfrageparameter

Parameter
updateMask

string (FieldMask format)

Maske, mit der angegeben wird, welche Felder in der Einreichung des Schülers aktualisiert werden sollen. Dieses Feld ist für eine Aktualisierung erforderlich. Die Aktualisierung schlägt fehl, wenn ungültige Felder angegeben werden.

Die folgenden Felder können von Lehrkräften angegeben werden:

  • draftGrade
  • assignedGrade

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

enum (PreviewVersion)

Optional. Die Vorabversion der API. Diese Einstellung muss festgelegt sein, um auf neue API-Funktionen zugreifen zu können, die Entwicklern im Vorabprogramm zur Verfügung gestellt werden.

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 Leitfaden zur Autorisierung.