Hiermit wird eine von einem Schüler oder Studenten eingereichte Aufgabe im Namen des Schülers oder Studenten zurückgefordert.
Wenn Sie eine von Schülern oder Studenten eingereichte Arbeit zurückfordern, wird die Eigentümerschaft an angehängten Drive-Dateien auf den Schüler oder Studenten übertragen und der Status der Einreichung wird aktualisiert.
Nur der Schüler/Student, der die angeforderte Einreichung eingereicht hat, darf diese Methode aufrufen und nur für eine eingereichte Einreichung.
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 eines Schülers oder Studenten zurückziehen oder Zugriffsfehler beheben möchte.FAILED_PRECONDITION, wenn die Aufgabe des Schülers oder Studenten nicht eingereicht wurde.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}:reclaim
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.me
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.