Method: courses.courseWork.studentSubmissions.reclaim

Fordert eine Schüleraufgabe im Namen des Schülers zurück, dem sie gehört.

Wenn eine Schüleraufgabe zurückgefordert wird, wird die Eigentümerschaft an angehängten Drive-Dateien auf den Schüler übertragen und der Status der Aufgabe aktualisiert.

Nur der Schüler, dem die angeforderte Schüleraufgabe gehört, kann diese Methode aufrufen. Dies ist nur für Schüleraufgaben möglich, die abgegeben wurden.

Diese Anfrage muss vom Developer Console-Projekt der OAuth-Client-ID gestellt werden, die zum Erstellen des entsprechenden Kurselements oder einer Add-on-Anlage im entsprechenden Kurselement 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, die angeforderte Schüleraufgabe zurückziehen oder wenn Zugriffsfehler auftreten.
  • FAILED_PRECONDITION, wenn die Schüleraufgabe nicht abgegeben wurde.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • NOT_FOUND, wenn der angeforderte Kurs, die angeforderte Kursarbeit oder die angeforderte Schüleraufgabe 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 von Classroom zugewiesene Kennung oder ein alias sein.
courseWorkId

string

Kennung der Kursarbeit.
id

string

Kennung der Schüleraufgabe.

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.