REST Resource: courses.courseWork.studentSubmissions

Ressource: StudentSubmission

Von Schülern/Studenten eingereichte Aufgaben

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

Bei Schüler-/Studentenbeiträgen, auf die noch nie zugegriffen wurde (d.h. mit state = NEW), 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 Kursaufgabe, auf die sich diese Antwort bezieht.

Schreibgeschützt.
id

string

Von Classroom zugewiesene Kennung für die Schüler- oder Studentenarbeit. Sie ist unter den Einsendungen für die entsprechende Kursaufgabe eindeutig.

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 dieses Antrags. Dieser Wert 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 dieses Antrags. Dieser Wert 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 überfällig ist.

Schreibgeschützt.
draftGrade

number

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

Diese sind nur für Kursleiter sichtbar und können nur von ihnen bearbeitet werden.
assignedGrade

number

Optional grade. Wenn nicht festgelegt, wurde keine Note vergeben. Dieser Wert darf nicht negativ sein. Dezimalwerte (also nicht ganzzahlige Werte) sind zulässig, werden aber auf zwei Dezimalstellen gerundet.

Diese können nur von Kursleitern geändert werden.
rubricId

string

Nur Ausgabe. Kennung des Schemas, das derzeit an diese Kursaufgabe angehängt ist und zum Benoten dieser Schüler-/Studenteneinsendung verwendet wird.

Diese ID ist leer, wenn es keine Rubrik gibt. Diese ID gibt das derzeit aktive Rubrik an. Sie ändert sich, wenn Lehrkräfte die Rubrik 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 Karte ist leer, wenn dieser Kursarbeit kein Bewertungsschema zugeordnet ist oder wenn ein Bewertungsschema zugeordnet ist, aber für kein Kriterium Noten festgelegt wurden. Einträge werden nur für Noten ausgefüllt, die festgelegt wurden. Schlüssel: Die Kriterien-ID der Rubrik.

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 Tabelle ist leer, wenn dieser Kursarbeit kein Bewertungsschema zugeordnet ist oder wenn ein Bewertungsschema zugeordnet ist, aber für kein Kriterium Noten festgelegt wurden. Einträge werden nur für Noten ausgefüllt, die festgelegt wurden. Schlüssel: Die Kriterien-ID der Rubrik.

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-/Studentenarbeit 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 Preview-Version der API. Diese Einstellung ist erforderlich, um auf neue API-Funktionen zuzugreifen, die Entwicklern im Vorabversionsprogramm zur Verfügung gestellt werden.
Union-Feld content. Inhalte der Einsendung. 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)

Eingabeinhalte, wenn „courseWorkType“ ASSIGNMENT ist.

Schüler und Studenten können diese Inhalte mit studentSubmissions.modifyAttachments bearbeiten.
shortAnswerSubmission

object (ShortAnswerSubmission)

Eingabeinhalte, wenn „courseWorkType“ SHORT_ANSWER_QUESTION ist.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Inhalte der Einreichung, wenn „courseWorkType“ MULTIPLE_CHOICE_QUESTION ist.

RubricGrade

Für die Aufgabe des Schülers/Studenten wurde eine Note auf Grundlage eines Bewertungsbogens festgelegt. Pro Rubrikkriterium ist maximal ein Eintrag zulässig.

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 Stufe ausgewählt.
points

number

Optional. Optionale Punkte, die für dieses Kriterium zugewiesen werden, in der Regel basierend auf der Stufe. Für Levels können Punkte vergeben werden. Wenn nicht festgelegt, wurden für dieses Kriterium keine Punkte vergeben.

AssignmentSubmission

Arbeiten von Schülern/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 oder Student noch nicht auf die Aufgabe in Classroom zugegriffen hat.

Einige Metadaten von Anhängen 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 des Schülers/Studenten wurde ein Anhang 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. Anhangdaten. Für attachment ist nur einer der folgenden Werte zulässig:
driveFile

object (DriveFile)

Google Drive-Datei anhängen
youTubeVideo

object (YouTubeVideo)

YouTube-Videoanhang
form

object (Form)

Google Formulare-Anhang

ShortAnswerSubmission

Arbeit eines Schülers/Studenten für eine Kurzantwort-Frage.

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

string

Antwort eines Schülers auf eine Kurzantwort-Frage.

MultipleChoiceSubmission

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

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

string

Auswahl des Schülers/Studenten.

SubmissionHistory

Verlauf der Einreichung. Dazu gehören derzeit der Verlauf von Bundesstaaten und Klassen.

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. Typ von „SubmissionHistory“. Mögliche Werte sind „StateHistory“ und „GradeHistory“. Für type ist nur einer der folgenden Werte zulässig:
stateHistory

object (StateHistory)

Die Informationen zum Statusverlauf des Antrags, falls vorhanden.
gradeHistory

object (GradeHistory)

Informationen zum Notenverlauf der Einsendung, falls vorhanden.

StateHistory

Der Verlauf der einzelnen Status, die diese Einreichung durchlaufen 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 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/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 Der Beitrag wurde erstellt.
TURNED_IN Der Schüler oder Student hat ein zugewiesenes Dokument abgegeben, das eine Vorlage sein kann.
RETURNED Der Kursleiter hat das zugewiesene Dokument an den Schüler oder Studenten zurückgegeben.
RECLAIMED_BY_STUDENT Der Schüler/Student hat das zugewiesene Dokument eingereicht und dann die Einreichung der Aufgabe zurückgenommen, sodass er als Eigentümer wieder die Kontrolle hat.
STUDENT_EDITED_AFTER_TURN_IN Der Schüler/Student hat seine Aufgabe nach der Abgabe noch einmal bearbeitet. Wird derzeit nur für Fragen verwendet, wenn der Schüler/Student seine Antwort bearbeitet.

GradeHistory

Der Verlauf jeder Note für diese Aufgabe.

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 Aufgabe.
maxPoints

number

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

string (Timestamp format)

Wenn die Note der Aufgabe 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

Der Kursleiter, der die Notenänderung vorgenommen 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 Typ für die Notenänderung angegeben. Dieser Wert sollte nie zurückgegeben werden.
DRAFT_GRADE_POINTS_EARNED_CHANGE Der Zähler der Note des Entwurfs ändert sich.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Eine Änderung des Zählers der zugewiesenen Note.
MAX_POINTS_CHANGE Eine Änderung der maximalen Punktzahl.

Methoden

get

 Gibt eine Aufgabe eines Schülers/Studenten zurück.

list

 Gibt eine Liste mit Schüler-/Studenteneinsendungen zurück, die der Anfragesteller ansehen darf, wobei die OAuth-Bereiche der Anfrage berücksichtigt werden.

modifyAttachments

 Ändert Anhänge von Schüler-/Studentenaufgaben.

patch

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

reclaim

 Fordert eine von einem Schüler oder Studenten eingereichte Aufgabe im Namen des Schülers oder Studenten zurück.

return

 Gibt eine Aufgabe eines Schülers/Studenten zurück.

turnIn

 Gibt eine Aufgabe eines Schülers/Studenten ab.