REST Resource: courses.courseWork.studentSubmissions

Ressource: Abgegebene Aufgaben

Eingereichte Schüler/Studenten für Kursarbeiten.

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

Für Aufgaben von Schülern/Studenten, auf die noch nie zugegriffen wurde (mit state = NEU), gibt es möglicherweise keinen Erstellungs- oder Aktualisierungszeitpunkt.

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

Kennung der entsprechenden Kursaufgabe.

Schreibgeschützt.
id

string

Von Classroom zugewiesene ID für die abgegebene Aufgabe des Schülers/Studenten. Diese ist einmalig für die jeweilige Kursaufgabe.

Schreibgeschützt.
userId

string

Die Kennung des Schülers/Studenten, dem diese Aufgabe gehört.

Schreibgeschützt.
creationTime

string (Timestamp format)

Erstellungszeit dieser Einreichung. Diese Einstellung kann deaktiviert werden, wenn der Schüler/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)

Zuletzt aktualisierter Zeitpunkt dieser Einreichung. Diese Einstellung kann deaktiviert werden, wenn der Schüler/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 der Einreichung.

Schreibgeschützt.
late

boolean

Gibt an, ob die Einreichung verspätet erfolgt.

Schreibgeschützt.
draftGrade

number

Optionale ausstehende Benotung. Ist die Richtlinie nicht konfiguriert, wurde keine Note festgelegt. Dieser Wert darf nicht negativ sein. Dezimalwerte (keine Ganzzahl) sind zulässig, werden aber auf zwei Dezimalstellen gerundet.

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

number

Benotung optional. Ist die Richtlinie nicht konfiguriert, wurde keine Note festgelegt. Dieser Wert darf nicht negativ sein. Dezimalwerte (keine Ganzzahl) sind zulässig, werden aber auf zwei Dezimalstellen gerundet.

Dies kann nur von Lehrkräften geändert werden.
rubricId

string

Nur Ausgabe. Kennzeichnung des Bewertungsschemas, das derzeit dieser Kursaufgabe zugeordnet ist und zur Benotung der abgegebenen Aufgabe von Schülern/Studenten verwendet wird.

Diese ID ist leer, wenn kein Bewertungsschema vorhanden ist. Diese ID spiegelt das derzeit aktive Bewertungsschema wider. Es ändert sich, wenn Lehrkräfte es löschen und neu erstellen.

Schreibgeschützt.

draftRubricGrades

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

Ausstehende Bewertungsschema-Noten basierend auf den Kriterien des Bewertungsschemas.

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

Den Bewertungskategorien wurden die Noten basierend auf den Kriterien des Bewertungsschemas zugewiesen.

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

Schreibgeschützt.
associatedWithDeveloper

boolean

Gibt an, ob die von einem Schüler/Studenten eingereichte Aufgabe 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 Aufgaben (einschließlich Status- und Notenverläufe).

Schreibgeschützt.
previewVersion

enum (PreviewVersion)

Nur Ausgabe. Die Vorschauversion der API. Dies muss festgelegt werden, um auf neue API-Funktionen zugreifen zu können, die Entwicklern im Vorschauprogramm zur Verfügung stehen.
Union-Feld content. Eingereichte Inhalte. Der spezifische Typ hängt vom Wert von course_work_type ab. Für content ist nur einer der folgenden Werte zulässig:
assignmentSubmission

object (AssignmentSubmission)

Inhalte werden eingereicht, wenn „courseWorkType“ den Wert ASSIGNMENT hat.

Schüler und Studenten können diesen Inhalt mit studentSubmissions.modifyAttachments ändern.
shortAnswerSubmission

object (ShortAnswerSubmission)

Eingereichte Inhalte, wenn „courseWorkType“ SHORT_ANSWER_QUESTION ist
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Inhalte werden eingereicht, wenn „courseWorkType“ den Wert MULTIPLE_CHOICE_QUESTION hat.

RubricGrade

Eine Note, die für die abgegebene Aufgabe des Schülers/Studenten festgelegt wurde. Pro Bewertungsschema-Kriterium ist maximal ein Beitrag möglich.

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 leer, wurde keine Ebene ausgewählt.
points

number

Optional. Optionale Punkte, die diesem Kriterium zugewiesen werden, in der Regel nach Level. Level können Punkte enthalten, müssen aber auch nicht. Wenn kein Wert festgelegt ist, 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)

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

Einige Metadaten von Anhängen werden nur eingefügt, wenn der anfragende Nutzer die Berechtigung zum Zugriff darauf hat. Die Felder „id“ und „alternativeLink“ sind immer verfügbar, andere hingegen nicht, z. B. „title“.

Anhang

Anhang für Aufgaben von Schülern/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)

Google Drive-Dateianhang.
youTubeVideo

object (YouTubeVideo)

YouTube-Videoanhang.
form

object (Form)

Google Formulare-Anhang.

ShortAnswerSubmission

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

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

string

Antwort des Schülers/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 Zustands- 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. Der Typ von Submission History, kann entweder State History oder Grade History 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 der einzelnen Bundesstaaten, in denen diese Einreichung stattgefunden hat.

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

enum (State)

Die Workflow-Pipelinephase.
stateTimestamp

string (Timestamp format)

Wann die Einreichung diesen Status erreicht 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 die Einreichung einer Einreichung.

Enums
STATE_UNSPECIFIED Kein Status angegeben. Dies sollte niemals zurückgegeben werden.
CREATED Die Einreichung wurde erstellt.
TURNED_IN Der Schüler/Student hat ein zugewiesenes Dokument eingereicht, bei dem es sich nicht um eine Vorlage handelt.
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 „Zurückziehen“ ausgewählt. die Aufgabe, sodass der Schüler oder Student wieder die Rolle des Eigentümers übernimmt.
STUDENT_EDITED_AFTER_TURN_IN Der Schüler/Student hat seine abgegebene Aufgabe bearbeitet. 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 Note zu diesem Zeitpunkt im Notenverlauf der abgegebenen Aufgaben.
maxPoints

number

Die maximale Punktzahl im Notenverlauf der abgegebenen Aufgaben zum jetzigen Zeitpunkt.
gradeTimestamp

string (Timestamp format)

Zeitpunkt, zu dem die Note der abgegebenen 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

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

enum (GradeChangeType)

Die Art der Notenänderung im Notenverlauf der abgegebenen Aufgaben zum aktuellen Zeitpunkt.

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 Eine Änderung des Zählers des Notenentwurfs.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Eine Änderung des Zählers der zugewiesenen Note.
MAX_POINTS_CHANGE Eine Änderung des Nenners der Note.

Methoden

get

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

list

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

modifyAttachments

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

patch

 Aktualisiert ein oder mehrere Felder einer abgegebenen Aufgabe eines Schülers/Studenten.

reclaim

 Eine abgegebene Aufgabe wird im Namen des Schülers/Studenten zurückgefordert, dem sie gehört.

return

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

turnIn

 Die Aufgabe eines Schülers/Studenten wird abgegeben.