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),

  // 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.
  "gradingPeriodId": string
}
Felder
courseId

string

Kennung des Kurses.

Schreibgeschützt.
id

string

Von Classroom zugewiesene Kennung für diese Kursaufgabe, die pro 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 Kursarbeit. Falls festgelegt, muss die Beschreibung ein gültiger UTF‑8-String mit maximal 30.000 Zeichen sein.
materials[]

object (Material)

Zusätzliche Materialien

CourseWork darf maximal 20 Materialien enthalten.
state

enum (CourseWorkState)

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

string (Timestamp format)

Der Zeitstempel für den Zeitpunkt, zu dem diese Kursaufgabe erstellt wurde.

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

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 in UTC, an dem die Einreichungen für diese Kursarbeit fällig sind. Muss angegeben werden, wenn dueTime angegeben ist.
dueTime

object (TimeOfDay)

Optionale Tageszeit in UTC, zu der die Einreichungen für diese Kursarbeit fällig sind. 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 null oder nicht angegeben ist, gilt die Aufgabe als unbenotet. Muss eine nicht negative Ganzzahl sein.
workType

enum (CourseWorkType)

Typ dieser Kursaufgabe.

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

boolean

Gibt an, ob dieses Kurselement mit dem Developer Console-Projekt verknüpft ist, über das die Anfrage gestellt wird.

Unter courseWork.create finden Sie weitere Informationen.

Schreibgeschützt.
assigneeMode

enum (AssigneeMode)

Zuweisungsmodus des Kurses. Wenn nicht angegeben, ist der Standardwert ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

Kennungen von Schülern/Studenten mit Zugriff auf die Kursmaterialien. Dieses Feld wird nur festgelegt, wenn assigneeMode INDIVIDUAL_STUDENTS ist. Wenn assigneeMode INDIVIDUAL_STUDENTS ist, werden die Kursmaterialien nur den in diesem Feld angegebenen Schülern und Studenten zugewiesen.
submissionModificationMode

enum (SubmissionModificationMode)

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

string

Kennung für den Nutzer, der den Kurs erstellt hat.

Schreibgeschützt.
topicId

string

Kennung für das Thema, mit dem dieser Kurs verknüpft ist. Muss mit einem vorhandenen Thema im Kurs übereinstimmen.
gradeCategory

object (GradeCategory)

Die Kategorie, zu der die Note für diese Kursarbeit beiträgt. Wird nur angezeigt, wenn eine Kategorie für die Kursarbeit ausgewählt wurde. Kann bei der Berechnung der Gesamtnote berücksichtigt werden.

Schreibgeschützt.
previewVersion

enum (PreviewVersion)

Nur Ausgabe. Die Vorschauversion der API, die zum Abrufen dieser Ressource verwendet wurde.
Union-Feld details. Zusätzliche Details, die sich auf eine bestimmte Art von Kursarbeit beziehen. Für details ist nur einer der folgenden Werte zulässig:
assignment

object (Assignment)

Details zur Aufgabe. Wird nur ausgefüllt, wenn workType ASSIGNMENT ist.

Schreibgeschützt.
multipleChoiceQuestion

object (MultipleChoiceQuestion)

Details zur Multiple-Choice-Frage. Bei Lesevorgängen wird dieses Feld nur ausgefüllt, wenn workType MULTIPLE_CHOICE_QUESTION ist. Bei Schreibvorgängen muss dieses Feld beim Erstellen von Kursaufgaben mit einem workType-Wert von MULTIPLE_CHOICE_QUESTION angegeben werden. Andernfalls darf es nicht festgelegt werden.
gradingPeriodId

string

Kennung des mit dem Kursmaterial verknüpften Zeitraums für die Benotung.

  • Wenn die Benotungszeitraum-ID bei der Erstellung nicht angegeben wird, wird sie basierend auf dueDate (oder scheduledTime, wenn kein dueDate festgelegt ist) festgelegt.
  • Wenn Sie keine Zuordnung zu einem beliebigen Zeitraum angeben möchten, legen Sie für dieses Feld einen leeren String ("") fest.
  • Falls angegeben, muss sie mit einer vorhandenen ID für den Bewertungszeitraum im Kurs übereinstimmen.

CourseWorkState

Mögliche Status von Kursaufgaben.

Enums
COURSE_WORK_STATE_UNSPECIFIED Kein Status angegeben. Dieser Wert wird nie zurückgegeben.
PUBLISHED Status für veröffentlichte Inhalte. Dies ist der Standardstatus.
DRAFT Status für Arbeiten, die noch nicht veröffentlicht wurden. Arbeiten in diesem Status sind nur für Kursleiter und Domainadministratoren sichtbar.
DELETED Status für Werke, die veröffentlicht, aber wieder gelöscht wurden. Arbeiten in diesem Status sind nur für Kursleiter und Domainadministratoren sichtbar. Arbeit in diesem Status wird nach einiger Zeit gelöscht.

SubmissionModificationMode

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

Enums
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Es wurde kein Änderungsmodus angegeben. Dieser Wert wird nie zurückgegeben.
MODIFIABLE_UNTIL_TURNED_IN Eingereichte Aufgaben können vor dem Einreichen bearbeitet werden.
MODIFIABLE Einsendungen können jederzeit geändert werden.

Assignment

Zusätzliche Details zu Aufgaben.

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

object (DriveFolder)

Drive-Ordner, in dem Anhänge aus Schüler-/Studentenbeiträgen abgelegt werden. Wird nur für Kursleiter und Administratoren ausgefüllt.

MultipleChoiceQuestion

Zusätzliche Details zu Multiple-Choice-Fragen.

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

string

Mögliche Auswahl.

Methoden

create

 Erstellt Kursaufgaben.

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 mit Kursaufgaben zurück, die der Antragsteller ansehen darf.

modifyAssignees

 Ändert den Zuweisungsmodus und die Optionen eines Kurses.

patch

 Aktualisiert ein oder mehrere Felder einer Kursaufgabe.