REST Resource: courses.courseWork.studentSubmissions

Ressource: StudentSubmission

Abgabe von Kursaufgaben durch Schüler/Studenten.

StudentSubmission-Elemente werden generiert, wenn ein CourseWork-Element erstellt wird.

Für von Schülern/Studenten eingereichte Aufgaben, auf die noch nie zugegriffen wurde (d.h. mit state = NEW), ist möglicherweise keine Erstellungs- oder Aktualisierungszeit vorhanden.

JSON-Darstellung 
{
  "courseId": string,
  "courseWorkId": string,
  "id": string,
  "userId": string,
  "creationTime": string,
  "updateTime": string,
  "state": enum (SubmissionState),
  "late": boolean,
  "draftGrade": number,
  "assignedGrade": number,
  "rubricId": string,
  "draftRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "assignedRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
}
Felder
courseId

string

ID des Kurses.

Schreibgeschützt.
courseWorkId

string

Kennung für die Kursaufgabe, der dies entspricht.

Schreibgeschützt.
id

string

In Classroom zugewiesene Kennung für die Abgabe des Schülers/Studenten. Diese ist unter den Einreichungen für die entsprechende Kursaufgabe eindeutig.

Schreibgeschützt.
userId

string

Kennung für den Schüler oder Studenten, der diese Abgabe eingereicht hat.

Schreibgeschützt.
creationTime

string (Timestamp format)

Erstellungszeitpunkt dieser Einreichung. Dieses Feld ist möglicherweise nicht festgelegt, wenn der Schüler oder Student nicht auf dieses Element zugegriffen hat.

Schreibgeschützt.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Zeitpunkt der letzten Aktualisierung dieser Einreichung. Dieses Feld ist möglicherweise nicht festgelegt, wenn der Schüler oder Student nicht auf dieses Element zugegriffen hat.

Schreibgeschützt.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
state

enum (SubmissionState)

Status dieser Einreichung.

Schreibgeschützt.
late

boolean

Gibt an, ob diese Einreichung verspätet ist.

Schreibgeschützt.
draftGrade

number

Optionale ausstehende Note. Wenn nicht festgelegt, wurde keine Note festgelegt. Dieser Wert darf nicht negativ sein. Dezimalwerte (also keine Ganzzahlen) sind zulässig, werden aber auf zwei Dezimalstellen gerundet.

Diese ist nur für Lehrkräfte des Kurses sichtbar und kann nur von ihnen geändert werden.
assignedGrade

number

Optionale Note. Wenn nicht festgelegt, wurde keine Note festgelegt. Dieser Wert darf nicht negativ sein. Dezimalwerte (also keine Ganzzahlen) sind zulässig, werden aber auf zwei Dezimalstellen gerundet.

Diese Einstellung kann nur von Kursleitern geändert werden.
rubricId

string

Nur Ausgabe. Kennung des Bewertungsschemas, das derzeit an diese Kursaufgabe angehängt ist und für die Benotung dieser Schüler-/Studentenabgabe verwendet wird.

Diese ID ist leer, wenn es keine Bewertungsrubrik gibt. Diese ID spiegelt das derzeit aktive Bewertungsschema wider. Sie ändert sich, wenn Lehrkräfte das Bewertungsschema löschen und neu erstellen.

Schreibgeschützt.

draftRubricGrades

map (key: string, value: object (RubricGrade))

Ausstehende Noten basierend auf den Kriterien des Bewertungsschemas.

Diese Karte ist leer, wenn der Kursaufgabe kein Bewertungsschema zugeordnet ist oder wenn zwar ein Bewertungsschema zugeordnet ist, aber für keine Kriterien Noten festgelegt wurden. Einträge werden nur für Noten ausgefüllt, die festgelegt wurden. Schlüssel: Die Kriterien-ID des Bewertungsschemas.

Schreibgeschützt.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
assignedRubricGrades

map (key: string, value: object (RubricGrade))

Zugewiesene Noten basierend auf den Kriterien des Bewertungsschemas.

Diese Karte ist leer, wenn der Kursaufgabe kein Bewertungsschema zugeordnet ist oder wenn zwar ein Bewertungsschema zugeordnet ist, aber für keine Kriterien Noten festgelegt wurden. Einträge werden nur für Noten ausgefüllt, die festgelegt wurden. Schlüssel: Die Kriterien-ID des Bewertungsschemas.

Schreibgeschützt.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
courseWorkType

enum (CourseWorkType)

Art der Kursaufgabe, für die diese Einreichung bestimmt ist.

Schreibgeschützt.
associatedWithDeveloper

boolean

Gibt an, ob diese Schüler-/Studentenabgabe mit dem Developer Console-Projekt verknüpft ist, von dem die Anfrage stammt.

Unter courseWork.create finden Sie weitere Informationen.

Schreibgeschützt.
submissionHistory[]

object (SubmissionHistory)

Der Verlauf der Einreichung (einschließlich Status- und Notenverlauf).

Schreibgeschützt.
previewVersion

enum (PreviewVersion)

Nur Ausgabe. Die Vorabversion der API. Dies muss festgelegt werden, um auf neue API-Funktionen zuzugreifen, die Entwicklern im Vorschauprogramm zur Verfügung gestellt werden.
Inhalt der Einreichung. Der genaue Typ hängt vom Wert von course_work_type ab. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
assignmentSubmission

object (AssignmentSubmission)

Inhalt der Abgabe, wenn „courseWorkType“ den Wert „ASSIGNMENT“ hat.

Schüler/Studenten können diese Inhalte mit studentSubmissions.modifyAttachments ändern.
shortAnswerSubmission

object (ShortAnswerSubmission)

Inhalt der Einreichung, wenn „courseWorkType“ den Wert „SHORT_ANSWER_QUESTION“ hat.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Inhalt der Abgabe, wenn „courseWorkType“ MULTIPLE_CHOICE_QUESTION ist.
Ende der sich gegenseitig ausschließenden Felder.

RubricGrade

Eine Bewertungsschema-Note, die für die eingereichte Aufgabe des Schülers/Studenten festgelegt wurde. Pro Rubrikkriterium gibt es maximal einen Eintrag.

JSON-Darstellung 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
Felder
criterionId

string

Optional. Kriteriums-ID.
levelId

string

Optional. Optionale Level-ID des ausgewählten Levels. Wenn das Feld leer ist, wurde keine Ebene ausgewählt.
points

number

Optional. Optionale Punkte, die diesem Kriterium zugewiesen werden, normalerweise basierend auf dem Niveau. Für Level können Punkte vergeben werden, müssen aber nicht. Wenn nicht festgelegt, wurden für dieses Kriterium keine Punkte festgelegt.

AssignmentSubmission

Aufgaben von Schülern/Studenten für eine Aufgabe.

JSON-Darstellung 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
Felder
attachments[]

object (Attachment)

Anhänge, die vom Schüler oder Studenten hinzugefügt wurden. Drive-Dateien, die Materialien mit dem Freigabemodus STUDENT_COPY entsprechen, sind möglicherweise noch nicht vorhanden, wenn der Schüler oder Student in Classroom noch nicht auf die Aufgabe zugegriffen hat.

Einige Anhangsmetadaten werden nur ausgefüllt, wenn der anfragende Nutzer die Berechtigung hat, darauf zuzugreifen. Die Felder „identifier“ und „alternateLink“ sind immer verfügbar, andere (z. B. „title“) möglicherweise nicht.

Anhang

Der Aufgabe eines Schülers/Studenten wurde ein Anhang hinzugefügt.

Beim Erstellen von Anhängen wird das Festlegen des Felds form nicht unterstützt.

JSON-Darstellung 
{

  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
}
Felder
Anhangsdaten. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
driveFile

object (DriveFile)

Google Drive-Dateianhang.
youTubeVideo

object (YouTubeVideo)

YouTube-Videoanhang.
form

object (Form)

Google Formulare-Anhang.
Ende der sich gegenseitig ausschließenden Felder.

ShortAnswerSubmission

Aufgaben von Schülern/Studenten für eine Kurzantwort-Frage.

JSON-Darstellung 
{
  "answer": string
}
Felder
answer

string

Antwort eines Schülers oder Studenten auf eine Kurzantwort-Frage.

MultipleChoiceSubmission

Aufgaben von Schülern/Studenten für eine Multiple-Choice-Frage.

JSON-Darstellung 
{
  "answer": string
}
Felder
answer

string

Auswahl des Schülers/Studenten.

SubmissionHistory

Der Verlauf der Einreichung. Dazu gehören derzeit der Status- und der Notenverlauf.

JSON-Darstellung 
{

  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
}
Felder
Typ von SubmissionHistory, kann StateHistory oder GradeHistory sein. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
stateHistory

object (StateHistory)

Die Informationen zum Statusverlauf der Einreichung, falls vorhanden.
gradeHistory

object (GradeHistory)

Die Informationen zum Notenverlauf der Einreichung, falls vorhanden.
Ende der sich gegenseitig ausschließenden Felder.

StateHistory

Der Verlauf der einzelnen Status, die diese Einreichung hatte.

JSON-Darstellung 
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
Felder
state

enum (State)

Die Phase der Workflowpipeline.
stateTimestamp

string (Timestamp format)

Wann die Einreichung diesen Status erreicht hat.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
actorUserId

string

Die Lehrkraft oder der Schüler oder Student, der die Änderung vorgenommen hat.

Bundesland

Mögliche Status für eine Einreichung.

Enums
STATE_UNSPECIFIED Kein Status angegeben. Dieser Wert sollte nie zurückgegeben werden.
CREATED Die Einreichung wurde erstellt.
TURNED_IN Der Schüler oder Student hat ein zugewiesenes Dokument abgegeben, das eine Vorlage sein kann, aber nicht muss.
RETURNED Die Lehrkraft hat das zugewiesene Dokument an den Schüler oder Studenten zurückgegeben.
RECLAIMED_BY_STUDENT Der Schüler oder Student hat das zugewiesene Dokument abgegeben und dann die Abgabe der Aufgabe rückgängig gemacht. Dadurch hat er wieder die Kontrolle als Eigentümer.
STUDENT_EDITED_AFTER_TURN_IN Der Schüler oder Student hat seine Einreichung nach der Abgabe noch einmal bearbeitet. Wird derzeit nur von Fragen verwendet, wenn der Schüler oder Student seine Antwort bearbeitet.

GradeHistory

Der Verlauf der einzelnen Noten für diese Abgabe.

JSON-Darstellung 
{
  "pointsEarned": number,
  "maxPoints": number,
  "gradeTimestamp": string,
  "actorUserId": string,
  "gradeChangeType": enum (GradeChangeType)
}
Felder
pointsEarned

number

Der Zähler der Note zu diesem Zeitpunkt im Notenverlauf der Abgabe.
maxPoints

number

Die maximale Punktzahl der Note zu diesem Zeitpunkt im Abgabeverlauf.
gradeTimestamp

string (Timestamp format)

Wann die Note der Einreichung geändert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
actorUserId

string

Die Lehrkraft, die die Note geändert hat.
gradeChangeType

enum (GradeChangeType)

Die Art der Notenänderung zu diesem Zeitpunkt im Änderungsverlauf der Noten für die Abgabe.

GradeChangeType

Mögliche Arten von Notenänderungen.

Enums
UNKNOWN_GRADE_CHANGE_TYPE Keine Art der Notenänderung angegeben. Dieser Wert sollte nie zurückgegeben werden.
DRAFT_GRADE_POINTS_EARNED_CHANGE Eine Änderung des Zählers der Entwurfsnote.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Eine Änderung des Zählers der zugewiesenen Note.
MAX_POINTS_CHANGE Eine Änderung der maximalen Punktzahl.

Methoden

get

 Gibt die Einreichung eines Schülers/Studenten zurück.

list

 Gibt eine Liste der von Schülern/Studenten eingereichten Aufgaben zurück, die der Anfragende einsehen darf. Dabei werden die OAuth-Bereiche der Anfrage berücksichtigt.

modifyAttachments

 Ändert Anhänge der eingereichten Aufgabe eines Schülers oder Studenten.

patch

 Aktualisiert ein oder mehrere Felder einer von einem Schüler oder Studenten eingereichten Aufgabe.

reclaim

 Fordert eine eingereichte Aufgabe im Namen des Schülers/Studenten zurück, der sie eingereicht hat.

return

 Gibt die Abgabe eines Schülers/Studenten zurück.

turnIn

 Gibt eine Schüler-/Studentenaufgabe ab.