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 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
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 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.