Method: courses.courseWork.studentSubmissions.reclaim

Die Aufgabe eines Schülers/Studenten wird im Namen des Schülers/Studenten zurückgefordert.

Wenn Sie die Aufgabe eines Schülers/Studenten zurückziehen, wird die Eigentümerschaft für die angehängten Drive-Dateien auf den Schüler/Studenten übertragen und der Abgabestatus wird aktualisiert.

Nur der Schüler/Student, dem die Aufgabe des Schülers/Studenten gehört, kann diese Methode aufrufen. Das gilt auch für die abgegebene Aufgabe des Schülers/Studenten.

Diese Anfrage muss über das Developer Console-Projekt der OAuth-Client-ID gestellt werden, die zur Erstellung des entsprechenden Arbeitselements des Kurses verwendet wurde.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht berechtigt ist, auf den angeforderten Kurs oder die angeforderte Kursaufgabe zuzugreifen, die angeforderte Einreichung des Schülers/Studenten zurückgezogen oder Zugriffsfehler vorliegt.
  • FAILED_PRECONDITION, wenn die Aufgabe des Schülers/Studenten noch nicht abgegeben wurde.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • NOT_FOUND, wenn der angeforderte Kurs, die angeforderte Kursaufgabe oder die Aufgabe des Schülers/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

ID des Kurses. Diese Kennung kann entweder die von Classroom zugewiesene ID oder eine alias sein.

courseWorkId

string

ID der Kursaufgabe.

id

string

ID der abgegebenen Aufgabe des Schülers/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.