REST Resource: courses.courseWork.studentSubmissions

Ressource: Schüler/Studenten

Abgegebene Aufgaben von Schülern/Studenten.

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

Abgegebene Aufgaben von Schülern/Studenten, auf die bisher noch nie zugegriffen wurde (state = NEU), dürfen keinen Erstellungs- oder Aktualisierungszeitpunkt angeben.

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

ID des Kurses.

Schreibgeschützt.

courseWorkId

string

ID der Kursaufgabe, der sie entspricht.

Schreibgeschützt.

id

string

Von Classroom zugewiesene ID für die abgegebene Aufgabe des Schülers/Studenten. Dies ist einzigartig unter den Einreichungen für die relevante Kursarbeit.

Schreibgeschützt.

userId

string

Kennzeichnung des Schülers/Studenten, der Eigentümer dieser Aufgabe ist.

Schreibgeschützt.

creationTime

string (Timestamp format)

Erstellungszeit dieser Einreichung. Diese Einstellung kann nicht festgelegt werden, wenn der Schüler oder Student noch nicht auf dieses Element zugegriffen hat.

Schreibgeschützt.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung 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. Diese Einstellung kann nicht festgelegt werden, wenn der Schüler oder Student noch nicht auf dieses Element zugegriffen hat.

Schreibgeschützt.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung 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

Gibt an, ob diese Einreichung überfällig ist.

Schreibgeschützt.

draftGrade

number

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

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

assignedGrade

number

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

Diese Einstellung kann nur von Lehrkräften geändert werden.

rubricId

string

Nur Ausgabe ID des Bewertungsschemas, das derzeit dieser Kursaufgabe zugewiesen ist und zur Benotung dieser abgegebenen Aufgabe verwendet wird.

Diese ID ist leer, wenn kein Bewertungsschema vorhanden ist. Diese ID entspricht dem aktuell aktiven Bewertungsschema. Sie ändert sich, wenn die Lehrkräfte das Bewertungsschema löschen und neu erstellen.

Schreibgeschützt.

draftRubricGrades

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

Ausstehende Bewertungsschemata benoten sich nach den Kriterien des Bewertungsschemas.

Diese Karte ist leer, wenn dieser Kursaufgabe kein Bewertungsschema zugewiesen ist oder wenn ein Bewertungsschema angehängt ist, aber keine Noten für irgendwelche Kriterien festgelegt wurden. Einträge werden nur für festgelegte Noten ausgefüllt. Schlüssel: Kriteriums-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))

Dem Bewertungsschema wurde basierend auf den Kriterien des Bewertungsschemas eine Note zugewiesen.

Diese Karte ist leer, wenn dieser Kursaufgabe kein Bewertungsschema zugewiesen ist oder wenn ein Bewertungsschema angehängt ist, aber für die Kriterien keine Noten vergeben wurden. Einträge werden nur für festgelegte Noten ausgefüllt. Schlüssel: Kriteriums-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 vorgesehen ist.

Schreibgeschützt.

associatedWithDeveloper

boolean

Gibt an, ob die Einreichung des Schülers/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 abgegebenen Aufgabe (einschließlich Status- und Notenverläufe).

Schreibgeschützt.

previewVersion

enum (PreviewVersion)

Nur Ausgabe Die Vorschauversion der API. Diese Einstellung muss aktiviert sein, damit Sie auf neue API-Funktionen zugreifen können, die Entwicklern im Vorschauprogramm zur Verfügung gestellt werden.

Union-Feld content. Eingereichte Inhalte Der jeweilige Typ hängt vom Wert von course_work_type ab. Für content ist nur einer der folgenden Werte zulässig:
assignmentSubmission

object (AssignmentSubmission)

Sie reichen Inhalte ein, wenn „courseWorkType“ auf ASSIGNMENT eingestellt ist.

Schüler und Studenten können diese Inhalte mithilfe von studentSubmissions.modifyAttachments ändern.

shortAnswerSubmission

object (ShortAnswerSubmission)

Sie reichen Inhalte ein, wenn „courseWorkType“ den Wert SHORT_ANSWER_QUESTION hat.

multipleChoiceSubmission

object (MultipleChoiceSubmission)

Inhalte einreichen, wenn „courseWorkType“ MULTIPLE_CHOICE_QUESTION ist.

RubricGrade

Eine für die abgegebene Aufgabe des Schülers/Studenten festgelegte Bewertungsschemanote. Pro Bewertungsschema 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 zugewiesen werden und in der Regel auf dem Level basieren. Level haben möglicherweise Punkte. Wenn kein Wert festgelegt ist, wurden für dieses Kriterium keine Punkte festgelegt.

AssignmentSubmission

Schüler/Studenten arbeiten an einer Aufgabe.

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

object (Attachment)

Vom Schüler oder 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 in Classroom auf die Aufgabe zugegriffen hat.

Einige Metadaten von Anhängen werden nur ausgefüllt, wenn der anfragende Nutzer die Berechtigung für den Zugriff darauf hat. Die Felder „ID“ und „alterLink“ sind immer verfügbar, andere Felder (z. B. „Titel“) jedoch 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
{

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

Google Drive-Dateianhang.

youTubeVideo

object (YouTubeVideo)

YouTube-Videoanhang.

form

object (Form)

Google Formulare-Anhang.

ShortAnswerSubmission

Die Schüler/Studenten arbeiten an einer Kurzantwort-Frage.

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

string

Antwort des Schülers/Studenten auf eine Kurzantwort-Frage

MultipleChoiceSubmission

Die Schüler/Studenten arbeiten an einer Multiple-Choice-Frage.

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

string

Auswahl des Schülers/Studenten.

SubmissionHistory

Der Verlauf der Einreichung. Dazu gehören derzeit auch Status- und Notenverläufe.

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. Type of SubmissionHistory, kann „StateHistory“ oder „GradeHistory“ sein. Für type ist nur einer der folgenden Werte zulässig:
stateHistory

object (StateHistory)

Die Statusverlaufsinformationen der Einreichung, falls vorhanden.

gradeHistory

object (GradeHistory)

Die Informationen zum Notenverlauf der abgegebenen Aufgabe, falls vorhanden.

StateHistory

Der Verlauf jedes Status, in dem sich diese Einreichung befand.

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

enum (State)

Phase der Workflow-Pipeline.

stateTimestamp

string (Timestamp format)

Wann die Einreichung diesen Status erreicht hat.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung 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 bzw. der die Änderung vorgenommen hat.

Status

Mögliche Status für eine Einreichung.

Enums
STATE_UNSPECIFIED Kein Bundesstaat angegeben. Dies sollte niemals zurückgegeben werden.
CREATED Die Einreichung wurde erstellt.
TURNED_IN Der Kursteilnehmer hat ein zugewiesenes Dokument eingereicht. Das kann eine Vorlage sein oder nicht.
RETURNED Die Lehrkraft hat das zugewiesene Dokument an den Schüler/Studenten zurückgegeben.
RECLAIMED_BY_STUDENT Der Schüler oder Student hat das zugewiesene Dokument abgegeben und hat dann entschieden, die Aufgabe zurückzuziehen, sodass der Schüler/Student wieder Eigentümer der Aufgabe ist.
STUDENT_EDITED_AFTER_TURN_IN Der Schüler/Student hat seine Aufgabe bearbeitet, nachdem er sie abgegeben hat. Wird derzeit nur für Fragen verwendet, wenn der Schüler oder Student seine Antwort bearbeitet.

GradeHistory

Der Verlauf der einzelnen Noten für diese Einreichung.

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

number

Der Zähler der aktuellen Note im Notenverlauf der abgegebenen Aufgaben.

maxPoints

number

Die maximale Punktzahl für die aktuelle Note im Notenverlauf von abgegebenen Aufgaben.

gradeTimestamp

string (Timestamp format)

Zeitpunkt, zu dem die Note der abgegebenen Aufgabe geändert wurde.

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

actorUserId

string

Die Lehrkraft, die die Notenänderung vorgenommen hat.

gradeChangeType

enum (GradeChangeType)

Die Art der Note ändert sich zu diesem Zeitpunkt im Notenverlauf der abgegebenen Aufgaben.

GradeChangeType

Mögliche Arten von Notenänderungen.

Enums
UNKNOWN_GRADE_CHANGE_TYPE Es wurde keine Art der Notenänderung angegeben. Dies sollte niemals zurückgegeben werden.
DRAFT_GRADE_POINTS_EARNED_CHANGE Der Zähler des Notenentwurfs wurde geändert.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Zähler der zugewiesenen Note wurde geändert.
MAX_POINTS_CHANGE Eine Änderung der Punktzahl.

Methoden

get

Gibt die abgegebene Aufgabe des Schülers/Studenten zurück.

list

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

modifyAttachments

Damit werden Anhänge zu abgegebenen Aufgaben von Schülern/Studenten geändert.

patch

Aktualisiert ein oder mehrere Felder einer abgegebenen Aufgabe.

reclaim

Die Aufgabe eines Schülers/Studenten wird im Namen des Schülers/Studenten zurückgefordert.

return

Gibt die abgegebene Aufgabe des Schülers/Studenten zurück.

turnIn

Die Aufgabe des Schülers/Studenten wird abgegeben.