Method: courses.courseWork.studentSubmissions.list

Gibt eine Liste der von Schülern/Studenten eingereichten Aufgaben zurück, die der Antragsteller sich ansehen darf. Dabei werden die OAuth-Bereiche der Anfrage berücksichtigt. - kann als courseWorkId angegeben werden, um die Einreichungen von Schülern/Studenten für mehrere Kurselemente zu berücksichtigen.

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

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht auf den angeforderten Kurs oder die angeforderten Kursmaterialien zugreifen darf, oder bei Zugriffsfehlern.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • NOT_FOUND, wenn der angeforderte Kurs nicht existiert.

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 in Classroom zugewiesene Kennung oder eine alias sein.
courseWorkId

string

Kennung der anzufordernden Schüler-/Studentenarbeit. Sie können dies auf das Stringliteral "-" festlegen, um die Schüler-/Studentenarbeit für alle Kursaufgaben im angegebenen Kurs anzufordern.

Abfrageparameter

Parameter
userId

string

Optionales Argument, um die zurückgegebenen Aufgaben von Schülern/Studenten auf die des Schülers/Studenten mit der angegebenen Kennung zu beschränken. Die Kennung kann eine der folgenden sein:

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

enum (SubmissionState)

Angefragte Abgabestatus Falls angegeben, entsprechen die zurückgegebenen Einreichungen von Schülern oder Studenten einem der angegebenen Einreichungsstatus.
late

enum (LateValues)

Angeforderter Wert für die Verzögerung. Wenn angegeben, werden zurückgegebene Schüler-/Studentenabgaben auf den angeforderten Wert beschränkt. Wenn nicht angegeben, werden Einreichungen unabhängig vom Wert von late zurückgegeben.
pageSize

integer

Die maximale Anzahl der Elemente, die zurückgegeben werden sollen. „0“ oder „nicht angegeben“ bedeutet, dass der Server ein Maximum 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 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 Vorabversion der API. Diese Einstellung muss festgelegt sein, um auf neue API-Funktionen zugreifen zu können, die Entwicklern im Vorabprogramm zur Verfügung gestellt werden.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort, wenn die Einreichungen von Schülern/Studenten aufgelistet werden.

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

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

object (StudentSubmission)

Schüler-/Studentenarbeit, die der Anfrage entspricht.
nextPageToken

string

Token, das die nächste Ergebnisseite identifiziert, die zurückgegeben werden soll. Ist das Feld leer, 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 Wert zurückgegebener Artikel nach Ablauf der Rückgabefrist

Enums
LATE_VALUES_UNSPECIFIED Es wurden keine Einschränkungen für verspätete Einreichungen angegeben.
LATE_ONLY Gibt „StudentSubmissions“, bei denen „late“ wahr ist, zurück.
NOT_LATE_ONLY Gibt „StudentSubmissions“, bei denen „late“ auf „false“ festgelegt ist, zurück.