REST Resource: courses.courseWork

Ressource: CourseWork

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 (Material)
    }
  ],
  "state": enum (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },

  // Union field details can be only one of the following:
  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  // End of list of possible types for union field details.
}
Felder
courseId

string

ID des Kurses.

Schreibgeschützt.

id

string

Die vom Kursraum zugewiesene ID dieser Kursaufgabe; eindeutig pro Kurs.

Schreibgeschützt.

title

string

Titel dieser Kursaufgabe. Der Titel muss ein gültiger UTF-8-String mit 1 bis 3.000 Zeichen sein.

description

string

Optionale Beschreibung dieser Kursaufgabe. Wenn festgelegt, muss die Beschreibung ein gültiger UTF-8-String mit maximal 30.000 Zeichen sein.

materials[]

object (Material)

Zusätzliche Materialien.

Kurswork darf nicht mehr als 20 Materialelemente enthalten.

state

enum (CourseWorkState)

Status dieser Kursarbeiten. Wenn keine Vorgabe erfolgt, gilt der Standardstatus DRAFT.

creationTime

string (Timestamp format)

Zeitstempel für die Erstellung dieser Kursaufgabe

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)

Zeitstempel der letzten Änderung an dieser Kursaufgabe.

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".

dueDate

object (Date)

Optionales Datum in UTC, an dem die Aufgaben für diese Kursaufgabe fällig sind. Dieser Wert muss angegeben werden, wenn dueTime festgelegt ist.

dueTime

object (TimeOfDay)

Optionale Tageszeit in UTC, zu der die Aufgaben für diese Kursaufgabe fällig sind. Dieser Wert muss angegeben werden, wenn dueDate festgelegt ist.

scheduledTime

string (Timestamp format)

Optionaler Zeitstempel für den Zeitpunkt, zu dem diese Kursaufgabe zur Veröffentlichung geplant ist.

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".

maxPoints

number

Höchstnote für diesen Kurs. Wenn null oder nicht angegeben, gilt diese Aufgabe als unbenotet. Dies muss eine nicht negative Ganzzahl sein.

workType

enum (CourseWorkType)

Art der Kursaufgabe

Der Typ wird beim Erstellen der Kursaufgabe festgelegt und kann nicht geändert werden.

associatedWithDeveloper

boolean

Gibt an, ob diese Kursaufgabe mit dem Developer Console-Projekt verknüpft ist, von dem die Anfrage stammt.

Unter courseWork.create finden Sie weitere Informationen.

Schreibgeschützt.

assigneeMode

enum (AssigneeMode)

Zuweisungsmodus der Kursaufgabe Wenn keine Vorgabe erfolgt, gilt der Standardwert ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

IDs der Kursteilnehmer mit Zugriff auf die Kursaufgaben Dieses Feld wird nur festgelegt, wenn assigneeMode den Wert INDIVIDUAL_STUDENTS hat. Wenn assigneeMode den Wert INDIVIDUAL_STUDENTS hat, wird die Kursaufgabe nur den in diesem Feld angegebenen Schülern oder Studenten zugewiesen.

submissionModificationMode

enum (SubmissionModificationMode)

Einstellung, mit der festgelegt wird, wann Schüler und Studenten abgegebene Aufgaben ändern dürfen. Wenn keine Vorgabe erfolgt, gilt der Standardwert MODIFIABLE_UNTIL_TURNED_IN.

creatorUserId

string

Kennung des Nutzers, der die Kursaufgabe erstellt hat.

Schreibgeschützt.

topicId

string

ID des Themas, mit dem diese Kursaufgabe verknüpft ist. Muss mit einem vorhandenen Thema im Kurs übereinstimmen.

gradeCategory

object (GradeCategory)

Die Kategorie, zu der die Note dieser Kursaufgabe gehört. 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, die sich auf eine bestimmte Art von Kursaufgabe beziehen. Für details ist nur einer der folgenden Werte zulässig:
assignment

object (Assignment)

Details zur Aufgabe. Dieses Feld wird nur ausgefüllt, wenn workType den Wert ASSIGNMENT hat.

Schreibgeschützt.

multipleChoiceQuestion

object (MultipleChoiceQuestion)

Details zu Multiple-Choice-Fragen. Bei Lesevorgängen wird dieses Feld nur gefüllt, wenn workType den Wert MULTIPLE_CHOICE_QUESTION hat. Für Schreibvorgänge muss dieses Feld beim Erstellen von Kursarbeiten mit einem workType von MULTIPLE_CHOICE_QUESTION angegeben werden. Ansonsten darf es nicht anders festgelegt werden.

Kurs-Arbeitsstatus

Mögliche Status von Kursarbeiten.

Enums
COURSE_WORK_STATE_UNSPECIFIED Kein Bundesstaat angegeben. Dies wird nie zurückgegeben.
PUBLISHED Status für ein veröffentlichtes Werk Dies ist der Standardstatus.
DRAFT Status für Arbeiten, die noch nicht veröffentlicht wurden. Arbeiten mit diesem Status sind nur für Lehrkräfte und Domainadministratoren sichtbar.
DELETED Status für ein Werk, das veröffentlicht, jetzt aber gelöscht wurde. Arbeiten mit diesem Status sind nur für Lehrkräfte und Domainadministratoren sichtbar. Arbeiten mit diesem Status werden nach einiger Zeit gelöscht.

Modus „SubmissionModificationMode“

Mögliche Änderungsmodi für abgegebene Aufgaben.

Enums
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Es wurde kein Änderungsmodus angegeben. Dies wird nie zurückgegeben.
MODIFIABLE_UNTIL_TURNED_IN Beiträge können vor der Abgabe noch geändert werden.
MODIFIABLE Beiträge können jederzeit geändert werden.

Assignment

Zusätzliche Details zu Zuweisungen.

JSON-Darstellung
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
Felder
studentWorkFolder

object (DriveFolder)

Google Drive-Ordner, in dem Anhänge von abgegebenen Aufgaben von Schülern/Studenten gespeichert werden. Dieses Feld wird nur für Lehrkräfte und Administratoren von Kursen ausgefüllt.

MultipleChoice-Frage

Weitere Informationen zu Multiple-Choice-Fragen

JSON-Darstellung
{
  "choices": [
    string
  ]
}
Felder
choices[]

string

Mögliche Auswahlmöglichkeiten.

Methoden

create

Erstellt Kursarbeiten.

delete

Löscht eine Kursaufgabe

get

Gibt die Kursaufgabe zurück.

getAddOnContext

Ruft Metadaten für Classroom-Add-ons im Kontext eines bestimmten Beitrags ab

list

Gibt eine Liste von Kursarbeiten zurück, die der Antragsteller ansehen darf

modifyAssignees

Ändert den Modus für Zuständige und die Optionen einer Kursaufgabe.

patch

Aktualisiert ein oder mehrere Felder einer Kursaufgabe