- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- LateValues
- Testen!
Gibt eine Liste der abgegebenen Aufgaben von Schülern/Studenten zurück, die der Anforderer einsehen darf, wobei die OAuth-Bereiche der Anfrage berücksichtigt werden. -
kann als courseWorkId
angegeben werden, um Aufgaben von Schülern/Studenten für mehrere Kursaufgaben einzubeziehen.
Kursteilnehmer sehen nur ihre eigenen Aufgaben. Kurslehrer und Domainadministratoren können alle abgegebenen Aufgaben von Schülern oder Studenten einsehen.
Diese Methode gibt die folgenden Fehlercodes zurück:
PERMISSION_DENIED
, wenn der anfragende Nutzer nicht berechtigt ist, auf den angeforderten Kurs oder die angeforderten Kursarbeiten zuzugreifen, oder wenn Zugriffsfehler aufgetreten sind.INVALID_ARGUMENT
, wenn die Anfrage fehlerhaft ist.NOT_FOUND
, wenn der angeforderte Kurs nicht vorhanden ist.
HTTP-Anfrage
GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
courseId |
ID des Kurses. Diese Kennung kann entweder die von Classroom zugewiesene ID oder eine |
courseWorkId |
ID der anzufragenden Arbeit des Schülers/Studenten. Dieses kann auf das Stringliteral |
Abfrageparameter
Parameter | |
---|---|
userId |
Optionales Argument, um die zurückgegebenen Aufgaben von Schülern/Studenten auf die Arbeiten des Schülers/Studenten mit der angegebenen ID zu beschränken. Folgende Kennzeichnungen sind möglich:
|
states[] |
Angeforderte Einreichungsstatus. Wenn angegeben, entsprechen die zurückgegebenen Aufgaben von Schülern/Studenten einem der angegebenen Abgabestatus. |
late |
Angeforderter Verspätungswert. Wenn angegeben, werden zurückgegebene Aufgaben von Schülern/Studenten durch den angeforderten Wert eingeschränkt. Wenn keine Vorgabe erfolgt, werden Einreichungen unabhängig vom Wert |
pageSize |
Maximale Anzahl der Artikel, die zurückgegeben werden sollen. Null oder nicht angegeben bedeutet, dass der Server ein Maximum zuweisen kann. Der Server gibt möglicherweise weniger Ergebnisse als die angegebene Anzahl zurück. |
pageToken |
Die |
previewVersion |
Optional. Die Vorschauversion der API. Diese Einstellung muss aktiviert sein, damit Sie auf neue API-Funktionen zugreifen können, die Entwicklern im Vorschauprogramm zur Verfügung gestellt werden. |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwort beim Auflisten der abgegebenen Aufgaben von Schülern oder Studenten.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"studentSubmissions": [
{
object ( |
Felder | |
---|---|
studentSubmissions[] |
Aufgaben von Schülern/Studenten, die der Anfrage entsprechen. |
nextPageToken |
Token, das die nächste Ergebnisseite identifiziert, die zurückgegeben werden soll. Wenn das Feld leer ist, sind keine weiteren Ergebnisse verfügbar. |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/classroom.coursework.students.readonly
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.students
https://www.googleapis.com/auth/classroom.coursework.me
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
LateValues
Einschränkungen in Bezug auf den späten Wert zurückgegebener Artikel.
Enums | |
---|---|
LATE_VALUES_UNSPECIFIED |
Keine Einschränkung für verspätete Werte bei der Einreichung angegeben. |
LATE_ONLY |
Abgaben von Schülern/Studenten zurückgeben, bei denen die Abgabefrist abgelaufen ist. |
NOT_LATE_ONLY |
StudentSubmissions zurückgeben, bei denen der Wert für die Abgabefrist „false“ lautet. |