Gibt die Einreichung eines Schülers/Studenten zurück.
Wenn Sie eine von einem Schüler oder Studenten eingereichte Aufgabe zurückgeben, geht die Eigentümerschaft an die angehängten Google Drive-Dateien auf den Schüler oder Studenten über. Möglicherweise wird auch der Status der Aufgabe aktualisiert. Im Gegensatz zur Classroom-Anwendung wird beim Zurückgeben einer von Schülern/Studenten eingereichten Aufgabe der Wert „assignedGrade“ nicht auf den Wert „draftGrade“ gesetzt.
Nur eine Lehrkraft des Kurses, der die angeforderte Einreichung des Schülers oder Studenten enthält, darf diese Methode aufrufen.
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 der anfragende Nutzer nicht auf den angeforderten Kurs oder die angeforderte Kursarbeit zugreifen darf, die angeforderte Einreichung des Schülers/Studenten zurückgeben 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
POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:return
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter | |
|---|---|
courseId |
Kennung des Kurses. Diese Kennung kann entweder die in Classroom zugewiesene Kennung oder eine |
courseWorkId |
Kennung der Kursarbeit. |
id |
Kennung der Aufgabe des Schülers oder 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.students
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.