- Ressource: Kursarbeit
- Kurs
- Datum
- Uhrzeit
- SubmissionModificationMode
- Zuweisung
- Multiple-Choice-Frage
- Methoden
Ressource: Kursarbeit
Kursarbeiten, die von einer Lehrkraft für die Teilnehmer des Kurses erstellt wurden.
JSON-Darstellung |
---|
{ "courseId": string, "id": string, "title": string, "description": string, "materials": [ { object ( |
Felder | |
---|---|
courseId |
ID des Kurses. Schreibgeschützt. |
id |
Von Classroom zugewiesene ID für diese Kursaufgabe. Eindeutige Kennung für jeden Kurs. Schreibgeschützt. |
title |
Titel der Kursaufgabe. Der Titel muss ein gültiger UTF-8-String mit 1 bis 3.000 Zeichen sein. |
description |
Optionale Beschreibung der Kursarbeiten. Wenn festgelegt, muss die Beschreibung ein gültiger UTF-8-String mit maximal 30.000 Zeichen sein. |
materials[] |
Zusätzliches Material. Kursarbeit darf nicht mehr als 20 Materialien enthalten. |
state |
Status dieses Kurses. Wenn keine Vorgabe erfolgt, gilt der Standardstatus |
alternateLink |
Der absolute Link zu diesem Kurs funktioniert in der Web-UI von Classroom. Wird nur ausgefüllt, wenn Schreibgeschützt. |
creationTime |
Zeitstempel für die Erstellung der Kursaufgabe. Schreibgeschützt. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit einer Auflösung von Nanosekunden und bis zu neun Nachkommastellen. Beispiele: |
updateTime |
Zeitstempel der letzten Änderung an diesem Kurs. Schreibgeschützt. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit einer Auflösung von Nanosekunden und bis zu neun Nachkommastellen. Beispiele: |
dueDate |
Optionales Datum in UTC, an dem Aufgaben für diesen Kurs fällig sind Dies muss angegeben werden, wenn |
dueTime |
Optionale Tageszeit in UTC, zu der die Aufgaben für diesen Kurs fällig sind Dies muss angegeben werden, wenn |
scheduledTime |
Optionaler Zeitstempel für die Veröffentlichung der Kursarbeiten. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit einer Auflösung von Nanosekunden und bis zu neun Nachkommastellen. Beispiele: |
maxPoints |
Maximale Note für diese Kursaufgabe. Wenn der Wert null oder nicht angegeben ist, gilt diese Aufgabe als unbenotet. Dies muss eine nicht negative Ganzzahl sein. |
workType |
Art der Kursaufgabe. Der Typ wird beim Erstellen der Kursaufgabe festgelegt und kann nicht geändert werden. |
associatedWithDeveloper |
Gibt an, ob dieses Kursaufgabe mit dem Entwicklerkonsolenprojekt verknüpft ist, von dem die Anfrage stammt. Unter Schreibgeschützt. |
assigneeMode |
Zuständiger Modus für die Kursaufgabe. Wenn keine Vorgabe erfolgt, gilt der Standardwert |
individualStudentsOptions |
IDs von Schülern/Studenten mit Zugriff auf die Kursaufgabe. Dieses Feld wird nur festgelegt, wenn |
submissionModificationMode |
Einstellung, mit der festgelegt wird, wann Schüler und Studenten Beiträge bearbeiten dürfen. Wenn keine Vorgabe erfolgt, gilt der Standardwert |
creatorUserId |
ID des Nutzers, der die Kursaufgabe erstellt hat. Schreibgeschützt. |
topicId |
Kennzeichnung des Themas, mit dem diese Kursaufgabe verknüpft ist. Muss mit einem vorhandenen Thema im Kurs übereinstimmen. |
gradeCategory |
Die Kategorie, zu der die Note dieser Kursaufgabe beiträgt. Nur präsentieren, wenn eine Kategorie für die Kursaufgabe ausgewählt wurde. Kann zur Berechnung der Gesamtnote verwendet werden. Schreibgeschützt. |
Union-Feld details . Zusätzliche Details zu einem Kurstyp. Für details ist nur einer der folgenden Werte zulässig: |
|
assignment |
Aufgabendetails. Dieses Feld wird nur ausgefüllt, wenn Schreibgeschützt. |
multipleChoiceQuestion |
Details zur Multiple-Choice-Frage. Bei Lesevorgängen wird dieses Feld nur ausgefüllt, wenn |
Kursarbeitsstatus
Mögliche Status der Arbeit.
Enums | |
---|---|
COURSE_WORK_STATE_UNSPECIFIED |
Kein Status angegeben. Das wird nie zurückgegeben. |
PUBLISHED |
Status für veröffentlichte Arbeiten. Das ist der Standardzustand. |
DRAFT |
Status für noch nicht veröffentlichte Arbeiten. Aufgaben in diesem Status sind nur für Lehrkräfte und Kursadministratoren sichtbar. |
DELETED |
Status für veröffentlichte Arbeiten, die jetzt gelöscht wurden. Aufgaben in diesem Status sind nur für Lehrkräfte und Kursadministratoren sichtbar. Aufgaben mit diesem Status werden nach einiger Zeit gelöscht. |
Datum
Stellt ein ganzes oder teilweises Kalenderdatum dar, z. B. einen Geburtstag. Tageszeit und Zeitzone sind entweder an anderer Stelle angegeben oder unbedeutend. Das Datum bezieht sich auf den gregorianischen Kalender. Das kann Folgendes sein:
- Ein vollständiges Datum mit Werten für Jahr, Monat und Tag ungleich null.
- Ein Monat und ein Tag mit einem Jahr von null, z. B. ein Jahrestag.
- Ein Jahr für sich – mit 0 Monaten und 0 Tagen
- Ein Jahr und ein Monat mit einem null Tag (z. B. ein Ablaufdatum einer Kreditkarte)
Ähnliche Typen:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON-Darstellung |
---|
{ "year": integer, "month": integer, "day": integer } |
Felder | |
---|---|
year |
Jahr des Datums. Der Wert muss zwischen 1 und 9999 oder 0 liegen, wenn ein Datum ohne Jahr angegeben werden soll. |
month |
Monat eines Jahres. Der Wert muss zwischen 1 und 12 oder 0 liegen, damit ein Jahr ohne Monat und Tag angegeben werden kann. |
day |
Tag eines Monats. Der Wert muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Sie kann auch 0 sein, um nur ein Jahr oder ein Jahr und einen Monat anzugeben, bei denen der Tag keine Bedeutung hat. |
TimeOfDay
Stellt eine Tageszeit dar. Das Datum und die Zeitzone sind entweder nicht relevant oder werden an anderer Stelle angegeben. Eine API kann Schaltsekunden zulassen. Vergleichbare Typen sind google.type.Date
und google.protobuf.Timestamp
.
JSON-Darstellung |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
Felder | |
---|---|
hours |
Stunden im 24-Stunden-Format. Sollte zwischen 0 und 23 liegen. Eine API kann den Wert "24:00:00" für Szenarien wie Geschäftsschlusszeit zulassen. |
minutes |
Minuten der Zeitangabe. Muss zwischen 0 und 59 liegen. |
seconds |
Sekunden der Zeitangabe. Muss normalerweise zwischen 0 und 59 liegen. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt. |
nanos |
Sekundenbruchteile in Nanosekunden. Muss zwischen 0 und 999.999.999 liegen. |
Modus der Einreichungsänderung
Mögliche Änderungsmodi für abgegebene Aufgaben
Enums | |
---|---|
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED |
Kein Änderungsmodus angegeben. Das wird nie zurückgegeben. |
MODIFIABLE_UNTIL_TURNED_IN |
Beiträge können vor ihrer Abgabe geändert werden. |
MODIFIABLE |
Beiträge können jederzeit geändert werden. |
Assignment
Zusätzliche Details für Zuweisungen.
JSON-Darstellung |
---|
{
"studentWorkFolder": {
object ( |
Felder | |
---|---|
studentWorkFolder |
Drive-Ordner, in dem Anhänge aus abgegebenen Aufgaben gespeichert werden Das Feld ist nur für Lehrkräfte und Administratoren des Kurses ausgefüllt. |
Multiple-Choice-Frage
Zusätzliche Details für Multiple-Choice-Fragen.
JSON-Darstellung |
---|
{ "choices": [ string ] } |
Felder | |
---|---|
choices[] |
Mögliche Auswahlmöglichkeiten. |
Methoden |
|
---|---|
|
Erstellt Kursarbeiten. |
|
Löscht eine Kursaufgabe. |
|
Gibt die Kursaufgabe zurück. |
|
Gibt eine Liste der Kursarbeiten zurück, die der Antragsteller ansehen darf. |
|
Ändert den Modus der zuständigen Person und die Optionen einer Kursaufgabe. |
|
Aktualisiert ein oder mehrere Felder einer Kursaufgabe. |