REST Resource: courses.courseWork.studentSubmissions

Ressource: StudentSubmission

Von Schülern/Studenten eingereichte Aufgaben für den Kurs.

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

Bei Einreichungen von Schülern/Studenten, auf die noch nie zugegriffen wurde (state = NEU), ist möglicherweise keine Erstellungs- oder Aktualisierungszeit angegeben.

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),

  // Union field content can be only one of the following:
  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
  // End of list of possible types for union field content.
}
Felder
courseId

string

Kennung des Kurses.

Schreibgeschützt.
courseWorkId

string

Kennung für die Kursarbeit, der dies entspricht.

Schreibgeschützt.
id

string

In Classroom zugewiesene Kennung für die Einreichung des Schülers oder Studenten. Dieser ist eindeutig unter den Einreichungen für die entsprechende Kursarbeit.

Schreibgeschützt.
userId

string

Kennung für den Schüler oder Studenten, dem diese Aufgabe gehört.

Schreibgeschützt.
creationTime

string (Timestamp format)

Zeitpunkt der Erstellung dieser Einreichung. Dieser Wert ist möglicherweise nicht festgelegt, wenn der Schüler oder Student nicht auf dieses Element zugegriffen hat.

Schreibgeschützt.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

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

Schreibgeschützt.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
state

enum (SubmissionState)

Status dieser Einreichung.

Schreibgeschützt.
late

boolean

Ob diese Einreichung überfällig ist.

Schreibgeschützt.
draftGrade

number

Optionale ausstehende Note. Wenn der Wert nicht festgelegt ist, wurde keine Note festgelegt. Dieser Wert darf nicht negativ sein. Dezimalwerte (d. h. nicht ganzzahlige Werte) sind zulässig, werden aber auf zwei Dezimalstellen gerundet.

Dieser ist nur für Kursleiter sichtbar und kann nur von ihnen geändert werden.
assignedGrade

number

Optionale Note. Wenn der Wert nicht festgelegt ist, wurde keine Note festgelegt. Dieser Wert darf nicht negativ sein. Dezimalwerte (d. h. nicht ganzzahlige Werte) sind zulässig, werden aber auf zwei Dezimalstellen gerundet.

Dieser kann nur von den Kursleitern geändert werden.
rubricId

string

Nur Ausgabe. Kennung der Benotungsskala, die derzeit mit dieser Kursarbeit verknüpft ist und für die Benotung dieser Einreichung des Schülers/Studenten verwendet wird.

Diese ID ist leer, wenn es keine Rubrik gibt. Diese ID entspricht der derzeit aktiven Benotungsskala. Sie ändert sich, wenn Lehrkräfte die Benotungsskala löschen und neu erstellen.

Schreibgeschützt.

draftRubricGrades

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

Ausstehende Noten für das Bewertungsschema basierend auf den Kriterien des Bewertungsschemas.

Diese Zuordnung ist leer, wenn dieser Kursarbeit keine Benotungsskala zugeordnet ist oder wenn eine Benotungsskala vorhanden ist, aber für keine Kriterien Noten festgelegt wurden. Einträge werden nur für Noten erfasst, die festgelegt wurden. Schlüssel: Die Kriteriums-ID der Benotungsskala.

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 für das Bewertungsschema basierend auf den Kriterien des Bewertungsschemas.

Diese Zuordnung ist leer, wenn dieser Kursarbeit keine Benotungsskala zugeordnet ist oder wenn eine Benotungsskala vorhanden ist, aber für keine Kriterien Noten festgelegt wurden. Einträge werden nur für Noten erfasst, die festgelegt wurden. Schlüssel: Die Kriteriums-ID der Benotungsskala.

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 Kursarbeit, für die diese Einreichung bestimmt ist.

Schreibgeschützt.
associatedWithDeveloper

boolean

Gibt an, ob diese Einreichung eines Schülers oder Studenten 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. Diese Einstellung muss festgelegt sein, um auf neue API-Funktionen zugreifen zu können, die Entwicklern im Vorabprogramm zur Verfügung gestellt werden.
Union-Feld content. Inhalt der Einreichung Der genaue Typ hängt vom Wert von course_work_type ab. Für content ist nur einer der folgenden Werte zulässig:
assignmentSubmission

object (AssignmentSubmission)

Inhalt der Einreichung, wenn „courseWorkType“ als „ASSIGNMENT“ festgelegt ist.

Schüler 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 Einreichung, wenn „courseWorkType“ MULTIPLE_CHOICE_QUESTION ist.

RubricGrade

Eine Note aus dem Bewertungsbogen, die für die Aufgabe des Schülers/Studenten festgelegt wurde. Pro Bewertungskriterium ist maximal ein Eintrag zulässig.

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

string

Optional. Kriteriums-ID.
levelId

string

Optional. Optionale Ebenen-ID der ausgewählten Ebene. Wenn das Feld leer ist, wurde keine Ebene ausgewählt.
points

number

Optional. Optionale Punkte, die für dieses Kriterium vergeben werden, in der Regel basierend auf dem Level. Ebenen können Punkte haben oder nicht. Wenn das Feld leer ist, wurden für dieses Kriterium keine Punkte festgelegt.

AssignmentSubmission

Die Arbeit eines Schülers/Studenten für eine Aufgabe.

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

object (Attachment)

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

Einige Anhängemetadaten werden nur dann erfasst, wenn der anfragende Nutzer die Berechtigung zum Zugriff darauf hat. Die Felder „ID“ und „alternateLink“ sind immer verfügbar, andere Felder (z. B. „title“) möglicherweise nicht.

Anhang

Anhang zur Aufgabe eines Schülers/Studenten hinzugefügt.

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

JSON-Darstellung 
{

  // Union field attachment can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field attachment.
}
Felder
Union-Feld attachment. Anhangsdaten. Für attachment ist nur einer der folgenden Werte zulässig:
driveFile

object (DriveFile)

Anhänge von Google Drive-Dateien
youTubeVideo

object (YouTubeVideo)

YouTube-Videoanhang
form

object (Form)

Anhang in Google Formulare

ShortAnswerSubmission

Schülerarbeit für eine Frage mit Kurzantwort

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

string

Antwort eines Schülers oder Studenten auf eine Frage mit Kurzantwort

MultipleChoiceSubmission

Schüler-/Studentenarbeit 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 Notenverlauf.

JSON-Darstellung 
{

  // Union field type can be only one of the following:
  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
  // End of list of possible types for union field type.
}
Felder
Union-Feld type. Der Typ von „SubmissionHistory“ kann „StateHistory“ oder „GradeHistory“ sein. Für type ist nur einer der folgenden Werte zulässig:
stateHistory

object (StateHistory)

Informationen zum Statusverlauf der Einreichung, sofern vorhanden.
gradeHistory

object (GradeHistory)

Die Informationen zum Notenverlauf der Aufgabe, sofern vorhanden.

StateHistory

Der Verlauf der einzelnen Status, in denen sich diese Einreichung befunden hat.

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

enum (State)

Die Workflow-Pipeline-Phase.
stateTimestamp

string (Timestamp format)

Wann die Einreichung diesen Status erhalten hat.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
actorUserId

string

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

Status

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 oder nicht.
RETURNED Die Lehrkraft hat das zugewiesene Dokument an den Schüler/Studenten zurückgegeben.
RECLAIMED_BY_STUDENT Der Schüler/Student hat das zugewiesene Dokument abgegeben und dann die Aufgabe zurückgezogen, um als Inhaber wieder die Kontrolle zu übernehmen.
STUDENT_EDITED_AFTER_TURN_IN Der Schüler/Student hat seine Aufgabe nach der Abgabe noch einmal bearbeitet. Wird derzeit nur bei Fragen verwendet, wenn der Schüler/Student seine Antwort bearbeitet.

GradeHistory

Die bisherige Benotung für diese Einreichung.

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

number

Der Nenner der Note zu diesem Zeitpunkt im Notenverlauf der Abgabe.
maxPoints

number

Der Nenner der Note zu diesem Zeitpunkt im Notenverlauf der Abgabe.
gradeTimestamp

string (Timestamp format)

Wann die Note der Aufgabe geändert wurde.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
actorUserId

string

Der Lehrer, der die Note geändert hat.
gradeChangeType

enum (GradeChangeType)

Die Art der Notenänderung zu diesem Zeitpunkt im Notenverlauf der Aufgabe.

GradeChangeType

Mögliche Arten von Notenänderungen

Enums
UNKNOWN_GRADE_CHANGE_TYPE Es wurde kein Notenänderungstyp angegeben. Dieser Wert sollte nie zurückgegeben werden.
DRAFT_GRADE_POINTS_EARNED_CHANGE Eine Änderung des Nenners der Note im Entwurf.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Eine Änderung des Nenners der zugewiesenen Note.
MAX_POINTS_CHANGE Eine Änderung der maximalen Punktzahl der Note.

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 Antragsteller sich ansehen darf. Dabei werden die OAuth-Bereiche der Anfrage berücksichtigt.

modifyAttachments

 Ändert Anhänge von abgegebenen Aufgaben von Schülern/Studenten.

patch

 Aktualisiert ein oder mehrere Felder einer Schüler-/Studenteneinreichung.

reclaim

 Hiermit wird eine von einem Schüler oder Studenten eingereichte Aufgabe im Namen des Schülers oder Studenten zurückgefordert.

return

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

turnIn

 Ein Schüler/Student gibt eine Aufgabe ab.