Method: courses.courseWork.studentSubmissions.reclaim

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

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.

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.