Method: courses.courseWork.studentSubmissions.list

Gibt eine Liste der Aufgaben von Schülern/Studenten zurück, die der Anforderer ansehen darf. Dabei werden die OAuth-Bereiche der Anfrage berücksichtigt. - kann als courseWorkId angegeben werden, um abgegebene Aufgaben von Schülern/Studenten für mehrere Kursarbeiten einzubeziehen.

Schüler/Studenten können nur ihre eigenen Aufgaben ansehen. Lehrkräfte und Domainadministratoren können sich alle abgegebenen Aufgaben von Schülern/Studenten ansehen.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht berechtigt ist, auf die angeforderte Kurs- oder Kursaufgabe zuzugreifen, oder wenn es Zugriffsfehler gibt.
  • 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 Kennung oder eine alias sein.
courseWorkId

string

ID der anzufordernden Schüler-/Studentenaufgabe. Es kann auf das Stringliteral "-" gesetzt werden, um 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 Kennung zu beschränken. Folgende Kennzeichnungen sind möglich:

  • die numerische Kennung für den Nutzer,
  • die E-Mail-Adresse des Nutzers
  • Das Stringliteral "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 abgegebene Aufgaben von Schülern/Studenten durch den angeforderten Wert beschränkt. Wenn kein Wert angegeben ist, werden Einreichungen unabhängig vom Wert late zurückgegeben.
pageSize

integer

Maximale Anzahl der Elemente, die zurückgegeben werden sollen. Null oder nicht angegeben bedeutet, dass der Server einen Höchstwert zuweisen kann.

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

string

nextPageToken-Wert, der von einem vorherigen list-Aufruf zurückgegeben wurde. Dieser Wert gibt an, dass die nachfolgende 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 Vorschauversion der API. Dies muss festgelegt werden, um auf neue API-Funktionen zugreifen zu können, die Entwicklern im Vorschauprogramm zur Verfügung stehen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort beim Auflisten von abgegebenen Aufgaben der Schüler/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 für den verspäteten Wert zurückgegebener Artikel.

Enums
LATE_VALUES_UNSPECIFIED Keine Beschränkung für Werte für verspätete Einreichungen angegeben.
LATE_ONLY „Student Submissions“ zurückgeben, wenn Verspätung vorliegt.
NOT_LATE_ONLY „Schüler/Studenten“ zurückgeben, wenn „verspätung“ „false“ ist.