Method: courses.courseWork.studentSubmissions.list

Gibt eine Liste mit Schüler-/Studenteneinsendungen zurück, die der Anfragesteller ansehen darf, wobei die OAuth-Bereiche der Anfrage berücksichtigt werden. Ein Bindestrich (-) kann als courseWorkId angegeben werden, um Schülereinreichungen für mehrere Kursaufgaben einzubeziehen.

Kursteilnehmer können nur ihre eigenen Aufgaben ansehen. Kursleiter und Domainadministratoren können alle von Schülern und Studenten eingereichten Aufgaben ansehen.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht berechtigt ist, auf den angeforderten Kurs oder die Kursarbeit zuzugreifen, oder bei Zugriffsfehlern.
  • 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

string

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

string

Kennung der Schüler-/Studentenarbeit, die angefordert werden soll. Dieser Wert kann auf das Stringliteral "-" gesetzt werden, um Schülerarbeiten für alle Kursarbeiten im angegebenen Kurs anzufordern.

Suchparameter

Parameter
userId

string

Optionales Argument, um zurückgegebene Aufgaben von Schülern/Studenten auf diejenigen zu beschränken, die dem Schüler/Studenten mit der angegebenen Kennung gehören. Die Kennung kann einer der folgenden Werte sein:

  • Die numerische Kennung für den Nutzer
  • die E‑Mail-Adresse des Nutzers
  • das Stringliteral "me", das den anfragenden Nutzer angibt
states[]

enum (SubmissionState)

Angefragte Einreichungsstatus. Falls angegeben, entsprechen zurückgegebene Schüler- und Studentenaufgaben einem der angegebenen Abgabestatus.
late

enum (LateValues)

Der angeforderte Wert für die Verspätung. Wenn angegeben, werden zurückgegebene Schüler-/Studentenaufgaben durch den angeforderten Wert eingeschränkt. Wenn nicht angegeben, werden Einsendungen unabhängig vom late-Wert zurückgegeben.
pageSize

integer

Maximale Anzahl der zurückzugebenden Elemente. Wenn der Wert 0 oder nicht angegeben ist, kann der Server ein Maximum zuweisen.

Der Server gibt möglicherweise weniger als die angegebene Anzahl von Ergebnissen zurück.
pageToken

string

Der nextPageToken-Wert, der von einem vorherigen list-Aufruf zurückgegeben wurde und angibt, dass die nächste Ergebnisseite zurückgegeben werden soll.

Die list-Anfrage muss ansonsten mit der Anfrage identisch sein, die zu diesem Token geführt hat.
previewVersion

enum (PreviewVersion)

Optional. Die Preview-Version der API. Diese Einstellung ist erforderlich, um auf neue API-Funktionen zuzugreifen, die Entwicklern im Vorabzugriffsprogramm zur Verfügung gestellt werden.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort beim Auflisten von Einreichungen von Schülern/Studenten.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "studentSubmissions": [
    {
      object (StudentSubmission)
    }
  ],
  "nextPageToken": string
}
Felder
studentSubmissions[]

object (StudentSubmission)

Aufgaben von Schülern/Studenten, die der Anfrage entsprechen.
nextPageToken

string

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

LateValues

Einschränkungen für den verspäteten Wert zurückgegebener Artikel.

Enums
LATE_VALUES_UNSPECIFIED Es wurde keine Einschränkung für verspätete Einreichungen angegeben.
LATE_ONLY Gibt StudentSubmissions zurück, bei denen „late“ auf „true“ gesetzt ist.
NOT_LATE_ONLY Gibt StudentSubmissions zurück, bei denen „late“ auf „false“ gesetzt ist.