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 dem Kurs zugewiesene ID dieser 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 Kursaufgabe. Wenn festgelegt, muss die Beschreibung ein gültiger UTF-8-String mit maximal 30.000 Zeichen sein.
materials[]

object (Material)

Zusätzliche Materialien.

Die Kursaufgabe darf nicht mehr als 20 Materialelemente enthalten.
state

enum (CourseWorkState)

Der Status dieser Kursarbeit. Wenn keine Vorgabe erfolgt, gilt der Standardstatus DRAFT.
creationTime

string (Timestamp format)

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

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 Beiträge für diese Kursaufgabe fällig sind. Dieser Wert muss angegeben werden, wenn dueTime angegeben ist.
dueTime

object (TimeOfDay)

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

string (Timestamp format)

Optionaler Zeitstempel für den Zeitpunkt, zu dem diese Kursaufgabe für die 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)

Die Art der Kursaufgabe.

Der Typ wird festgelegt, wenn die Kursaufgabe erstellt wird, 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)

Modus „Zuständige Person“ der Kursaufgaben Wenn keine Vorgabe erfolgt, gilt der Standardwert ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

IDs der Lernenden 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 nur die in diesem Feld angegebenen Schüler/Studenten die Kursaufgabe erhalten.
submissionModificationMode

enum (SubmissionModificationMode)

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

string

Kennung des Nutzers, der die Kursaufgaben erstellt hat.

Schreibgeschützt.
topicId

string

ID 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. Nur vorhanden sein, wenn eine Kategorie für die Kursaufgabe ausgewählt wurde. Kann für die Berechnung der Gesamtnote verwendet werden.

Schreibgeschützt.
Union-Feld details. Zusätzliche Details, die sich auf eine Art von Kursaufgabe beziehen. Für details ist nur einer der folgenden Werte zulässig:
assignment

object (Assignment)

Aufgabendetails. 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 ausgefüllt, wenn workType den Wert MULTIPLE_CHOICE_QUESTION hat. Für Schreibvorgänge muss dieses Feld beim Erstellen von Kursarbeiten mit dem workType-Wert MULTIPLE_CHOICE_QUESTION angegeben werden. Ansonsten darf das Feld nicht anders festgelegt werden.

CourseWorkState

Mögliche Zustände von Kursarbeiten.

Enums
COURSE_WORK_STATE_UNSPECIFIED Kein Bundesstaat angegeben. Dies wird nie zurückgegeben.
PUBLISHED Status für veröffentlichte Arbeiten. Dies ist der Standardstatus.
DRAFT Status für Arbeiten, die noch nicht veröffentlicht wurden. Arbeiten in diesem Status sind nur für Kurslehrer und Domainadministratoren sichtbar.
DELETED Status für Arbeiten, die veröffentlicht, aber gelöscht wurden. Arbeiten in diesem Status sind nur für Kurslehrer und Domainadministratoren sichtbar. Arbeiten mit diesem Status werden nach einiger Zeit gelöscht.

SubmissionModificationMode

Mögliche Änderungsmodi für abgegebene Aufgaben.

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

Assignment

Zusätzliche Details für Zuweisungen.

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

object (DriveFolder)

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

MultipleChoiceQuestion

Weitere Informationen zu Multiple-Choice-Fragen

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

string

Mögliche Auswahlmöglichkeiten.

Methoden

create

 Kursarbeiten erstellen

delete

 Löscht eine Kursaufgabe.

get

 Gibt Kursarbeiten zurück.

getAddOnContext

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

list

 Gibt eine Liste der Kursarbeiten zurück, die der Anforderer ansehen darf.

modifyAssignees

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

patch

 Aktualisiert ein oder mehrere Felder einer Kursaufgabe.