REST Resource: courses.courseWork

Ressource: CourseWork

Kursaufgaben, die von einer Lehrkraft für die Schüler/Studenten 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)
  },
  "previewVersion": enum (PreviewVersion),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "gradingPeriodId": string
}
Felder
courseId

string

ID des Kurses.

Schreibgeschützt.
id

string

In Classroom zugewiesene Kennung dieser Kursaufgabe, die für jeden Kurs eindeutig ist.

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 die Beschreibung festgelegt ist, muss sie ein gültiger UTF-8-String mit maximal 30.000 Zeichen sein.
materials[]

object (Material)

Zusätzliche Materialien.

Kursaufgaben dürfen nicht mehr als 20 Materialelemente enthalten.
state

enum (CourseWorkState)

Status dieser Kursarbeit. Wenn nicht angegeben, ist der Standardstatus DRAFT.
creationTime

string (Timestamp format)

Zeitstempel für die Erstellung dieser Kursarbeit.

Schreibgeschützt.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Zeitstempel der letzten Änderung an dieser Kursarbeit.

Schreibgeschützt.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
dueDate

object (Date)

Optionales Datum (UTC), bis zu dem Einreichungen für diese Kursarbeit fällig sind. Dies muss angegeben werden, wenn dueTime angegeben ist.
dueTime

object (TimeOfDay)

Optionale Tageszeit in UTC, bis zu der Einreichungen für diese Kursaufgabe fällig sind. Dies muss angegeben werden, wenn dueDate angegeben ist.
scheduledTime

string (Timestamp format)

Optionaler Zeitstempel für den Zeitpunkt, zu dem diese Kursaufgabe veröffentlicht werden soll.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
maxPoints

number

Maximale Note für diese Kursaufgabe. Wenn der Wert „0“ ist oder nicht angegeben wird, gilt die Aufgabe als nicht benotet. Dies muss eine nicht negative Ganzzahl sein.
workType

enum (CourseWorkType)

Typ dieser Kursaufgabe.

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

boolean

Gibt an, ob dieses Kursarbeits-Element 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)

Modus für die zuständige Person der Kursaufgabe. Wenn nicht angegeben, ist der Standardwert ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

IDs von Schülern/Studenten mit Zugriff auf die Kursaufgaben. Dieses Feld wird nur festgelegt, wenn assigneeMode den Wert INDIVIDUAL_STUDENTS hat. Wenn assigneeMode den Wert INDIVIDUAL_STUDENTS hat, werden die Kursaufgaben nur den in diesem Feld angegebenen Schülern/Studenten zugewiesen.
submissionModificationMode

enum (SubmissionModificationMode)

Einstellung, mit der festgelegt wird, wann Schüler/Studenten eingereichte Aufgaben ändern dürfen. Wenn nicht angegeben, ist der Standardwert MODIFIABLE_UNTIL_TURNED_IN.
creatorUserId

string

ID des Nutzers, der die Kursaufgabe erstellt hat.

Schreibgeschützt.
topicId

string

Kennung für das Thema, 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 beiträgt. Wird nur angezeigt, wenn für die Kursaufgabe eine Kategorie ausgewählt wurde. Kann bei der Berechnung der Gesamtnote verwendet werden.

Schreibgeschützt.
previewVersion

enum (PreviewVersion)

Nur Ausgabe. Die Vorabversion der API, die zum Abrufen dieser Ressource verwendet wurde.
learningGoals[]

object (LearningGoal)

Optional.

Verweise auf Lernziele, die mit dieser Kursaufgabe verknüpft sind. Kursaufgaben können maximal 10 Lernziele haben. Dieses Feld wird nur ausgefüllt, wenn der entsprechende previewVersion festgelegt ist.
Zusätzliche Details, die für einen bestimmten Kursarbeitstyp spezifisch sind. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
assignment

object (Assignment)

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

Schreibgeschützt.
multipleChoiceQuestion

object (MultipleChoiceQuestion)

Details zur Multiple-Choice-Frage. Bei Lesevorgängen wird dieses Feld nur ausgefüllt, wenn workType den Wert MULTIPLE_CHOICE_QUESTION hat. Bei Schreibvorgängen muss dieses Feld beim Erstellen von Kursaufgaben mit einem workType von MULTIPLE_CHOICE_QUESTION angegeben werden. Andernfalls darf es nicht festgelegt werden.
Ende der sich gegenseitig ausschließenden Felder.
gradingPeriodId

string

ID des Benotungszeitraums, der mit der Kursarbeit verknüpft ist.

  • Wenn bei der Erstellung keine ID für den Benotungszeitraum angegeben wird, wird sie anhand des dueDate festgelegt (oder des scheduledTime, wenn kein dueDate festgelegt ist).
  • Wenn Sie keine Verknüpfung mit einem Benotungszeitraum angeben möchten, legen Sie für dieses Feld einen leeren String („“) fest.
  • Falls angegeben, muss sie mit einer vorhandenen Benotungszeitraum-ID im Kurs übereinstimmen.

CourseWorkState

Mögliche Status von Kursarbeiten.

Enums
COURSE_WORK_STATE_UNSPECIFIED Kein Status angegeben. Wird nie zurückgegeben.
PUBLISHED Status für veröffentlichte Aufgaben. Dies ist der Standardstatus.
DRAFT Status für Arbeiten, die noch nicht veröffentlicht wurden. In diesem Status sind die Aufgaben nur für Lehrkräfte und Domainadministratoren sichtbar.
DELETED Status für veröffentlichte, aber jetzt gelöschte Arbeit. In diesem Status sind die Aufgaben nur für Lehrkräfte und Domainadministratoren sichtbar. Arbeiten in diesem Status werden nach einiger Zeit gelöscht.

SubmissionModificationMode

Mögliche Änderungsmodi für von Schülern/Studenten eingereichte Aufgaben.

Enums
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Kein Änderungsmodus angegeben. Wird nie zurückgegeben.
MODIFIABLE_UNTIL_TURNED_IN Eingereichte Aufgaben können vor der Abgabe geändert werden.
MODIFIABLE Einreichungen können jederzeit geändert werden.

Assignment

Zusätzliche Details für Aufgaben.

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

object (DriveFolder)

Drive-Ordner, in dem Anhänge aus den Abgaben von Schülern/Studenten abgelegt werden. Dieses Feld wird nur für Lehrkräfte und Administratoren des Kurses ausgefüllt.

MultipleChoiceQuestion

Zusätzliche Details für Multiple-Choice-Fragen.

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

string

Mögliche Optionen.

Methoden

create

 Kursaufgaben erstellt

delete

 Löscht eine Kursaufgabe.

get

 Gibt Kursaufgaben zurück.

getAddOnContext

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

list

 Gibt eine Liste der Kursaufgaben zurück, die der Anfragende sehen darf.

modifyAssignees

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

patch

 Aktualisiert ein oder mehrere Felder einer Kursarbeit.