Method: courses.courseWork.studentSubmissions.list

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

string

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

courseWorkId

string

ID der anzufragenden Arbeit des Schülers/Studenten. Dieses kann auf das Stringliteral "-" festgelegt werden, um die Aufgaben von Schülern/Studenten für alle Kursarbeiten im angegebenen Kurs anzufordern.

Abfrageparameter

Parameter
userId

string

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:

  • Numerische Kennung des Nutzers
  • die E-Mail-Adresse des Nutzers
  • das String-Literal "me", das den anfragenden Nutzer angibt
states[]

enum (SubmissionState)

Angeforderte Einreichungsstatus. Wenn angegeben, entsprechen die zurückgegebenen Aufgaben von Schülern/Studenten einem der angegebenen Abgabestatus.

late

enum (LateValues)

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 late zurückgegeben.

pageSize

integer

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

string

nextPageToken-Wert, der von einem vorherigen list-Aufruf zurückgegeben wurde. Dieser gibt an, dass die nachfolgende Ergebnisseite zurückgegeben werden soll.

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

previewVersion

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