- Ressource: StudentSubmission
- RubricGrade
- AssignmentSubmission
- Anhang
- ShortAnswerSubmission
- MultipleChoiceSubmission
- SubmissionHistory
- StateHistory (Statusverlauf)
- Bundesland
- GradeHistory
- GradeChangeType
- Methoden
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 ( |
Felder | |
---|---|
courseId |
ID des Kurses. Schreibgeschützt. |
courseWorkId |
ID der Kursaufgabe, der sie entspricht. Schreibgeschützt. |
id |
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 |
Kennzeichnung des Schülers/Studenten, der Eigentümer dieser Aufgabe ist. Schreibgeschützt. |
creationTime |
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: |
updateTime |
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: |
state |
Status dieser Einreichung. Schreibgeschützt. |
late |
Gibt an, ob diese Einreichung überfällig ist. Schreibgeschützt. |
draftGrade |
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 |
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 |
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 |
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 |
assignedRubricGrades |
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 |
alternateLink |
Absoluter Link zur Aufgabe in der Classroom-Weboberfläche. Schreibgeschützt. |
courseWorkType |
Art der Kursaufgabe, für die diese Einreichung vorgesehen ist. Schreibgeschützt. |
associatedWithDeveloper |
Gibt an, ob die Einreichung des Schülers/Studenten mit dem Developer Console-Projekt verknüpft ist, von dem die Anfrage stammt. Unter Schreibgeschützt. |
submissionHistory[] |
Der Verlauf der abgegebenen Aufgabe (einschließlich Status- und Notenverläufe). Schreibgeschützt. |
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 |
Sie reichen Inhalte ein, wenn „courseWorkType“ auf ASSIGNMENT eingestellt ist. Schüler und Studenten können diese Inhalte mithilfe von |
shortAnswerSubmission |
Sie reichen Inhalte ein, wenn „courseWorkType“ den Wert SHORT_ANSWER_QUESTION hat. |
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 |
Optional. Kriteriums-ID |
levelId |
Optional. Optionale Ebenen-ID der ausgewählten Ebene. Wenn das Feld leer ist, wurde keine Ebene ausgewählt. |
points |
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 ( |
Felder | |
---|---|
attachments[] |
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 |
Felder | |
---|---|
Union-Feld attachment . Anhangsdaten Für attachment ist nur einer der folgenden Werte zulässig: |
|
driveFile |
Google Drive-Dateianhang. |
youTubeVideo |
YouTube-Videoanhang. |
link |
Linkanhang. |
form |
Google Formulare-Anhang. |
ShortAnswerSubmission
Die Schüler/Studenten arbeiten an einer Kurzantwort-Frage.
JSON-Darstellung |
---|
{ "answer": string } |
Felder | |
---|---|
answer |
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 |
Auswahl des Schülers/Studenten. |
SubmissionHistory
Der Verlauf der Einreichung. Dazu gehören derzeit auch Status- und Notenverläufe.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld type . Type of SubmissionHistory, kann „StateHistory“ oder „GradeHistory“ sein. Für type ist nur einer der folgenden Werte zulässig: |
|
stateHistory |
Die Statusverlaufsinformationen der Einreichung, falls vorhanden. |
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 ( |
Felder | |
---|---|
state |
Phase der Workflow-Pipeline. |
stateTimestamp |
Wann die Einreichung diesen Status erreicht hat. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
actorUserId |
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 ( |
Felder | |
---|---|
pointsEarned |
Der Zähler der aktuellen Note im Notenverlauf der abgegebenen Aufgaben. |
maxPoints |
Die maximale Punktzahl für die aktuelle Note im Notenverlauf von abgegebenen Aufgaben. |
gradeTimestamp |
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: |
actorUserId |
Die Lehrkraft, die die Notenänderung vorgenommen hat. |
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 |
|
---|---|
|
Gibt die abgegebene Aufgabe des Schülers/Studenten zurück. |
|
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. |
|
Damit werden Anhänge zu abgegebenen Aufgaben von Schülern/Studenten geändert. |
|
Aktualisiert ein oder mehrere Felder einer abgegebenen Aufgabe. |
|
Die Aufgabe eines Schülers/Studenten wird im Namen des Schülers/Studenten zurückgefordert. |
|
Gibt die abgegebene Aufgabe des Schülers/Studenten zurück. |
|
Die Aufgabe des Schülers/Studenten wird abgegeben. |