Hiermit wird eine von einem Schüler oder Studenten eingereichte Aufgabe im Namen des Schülers oder Studenten zurückgefordert.
Wenn Sie die Rücknahme einer Einreichung eines Schülers oder Studenten beantragen, 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 oder Student, der die angeforderte Einreichung eingereicht hat, 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 eines Schülers oder Studenten zurückziehen oder bei Zugriffsfehlern.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 | |
---|---|
course |
Kennung des Kurses. Diese Kennung kann entweder die in Classroom zugewiesene Kennung oder eine |
course |
Kennung der Kursarbeit. |
id |
Kennung der Aufgabe des Schülers oder Studenten. |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/classroom.coursework.me
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.