Method: courses.courseWork.studentSubmissions.turnIn

Gibt eine Aufgabe eines Schülers/Studenten ab.

Wenn eine Aufgabe eines Schülers/Studenten abgegeben wird, wird die Eigentümerschaft an angehängten Drive-Dateien an die Lehrkraft übertragen. Außerdem kann der Status der Aufgabe aktualisiert werden.

Diese Methode kann nur von dem Schüler/Studenten aufgerufen werden, dem die angegebene Aufgabe gehört.

Diese Anfrage muss vom Developer Console-Projekt der OAuth-Client-ID gestellt werden, die zum Erstellen des entsprechenden Kursarbeitselements oder eines Add-on-Anhangs für das entsprechende Kursarbeitselement verwendet wurde.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED wenn der anfragende Nutzer nicht berechtigt ist, auf den angeforderten Kurs oder die angeforderte Kursarbeit zuzugreifen, die angeforderte Aufgabe des Schülers/Studenten abzugeben oder wenn Zugriffsfehler auftreten.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • NOT_FOUND, wenn der angeforderte Kurs, die angeforderte Kursarbeit oder die angeforderte Aufgabe des Schülers/Studenten nicht vorhanden ist.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

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

courseWorkId

string

Kennung der Kursarbeit.

id

string

Kennung der Einreichung des Schülers/Studenten.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, ist der Antworttext ein leeres JSON-Objekt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Autorisierungsleitfaden.