Method: courses.courseWork.studentSubmissions.return

Gibt die abgegebene Aufgabe des Schülers/Studenten zurück.

Wenn Sie die Aufgabe zurückgeben, wird die Eigentümerschaft für die angehängten Drive-Dateien auf den Schüler/Studenten übertragen. Außerdem wird möglicherweise der Abgabestatus aktualisiert. Im Gegensatz zur Classroom-Anwendung wird „assignGrade“ beim Zurückgeben einer abgegebenen Aufgabe eines Schülers/Studenten nicht auf den Wert draftGrade festgelegt.

Nur eine Lehrkraft des Kurses, der die angeforderte Einreichung enthält, kann diese Methode aufrufen.

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ückzugeben oder Zugriffsfehler aufgetreten ist.
  • 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}:return

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.