REST Resource: courses.courseWork

Ressource: CourseWork

Kursarbeiten, die von einer Lehrkraft für 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

ID des Kurses.

Schreibgeschützt.

id

string

Die von 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 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 Material-Elemente enthalten.

state

enum (CourseWorkState)

Status dieser Kursaufgabe. Wenn keine Vorgabe erfolgt, lautet der Standardstatus DRAFT.

creationTime

string (Timestamp format)

Zeitstempel für die Erstellung dieser Kursaufgabe.

Schreibgeschützt.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich 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 einer Auflösung im Nanosekundenbereich 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 für den Abgabetermin von Aufgaben für diese Kursaufgabe. Dies muss angegeben werden, wenn dueTime angegeben ist.

dueTime

object (TimeOfDay)

Optionale Tageszeit in UTC, in der die Einreichungen für diese Kursarbeit fällig sind. Dies muss angegeben werden, wenn dueDate angegeben ist.

scheduledTime

string (Timestamp format)

Optionaler Zeitstempel für die geplante Veröffentlichung dieser Kursaufgabe.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

maxPoints

number

Höchstnote für diese Kursaufgabe. Wenn keine Angabe oder keine Angabe vorliegt, gilt die 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 dieses Kurselement 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 „Zugewiesene Person“ der Kursaufgabe. Wenn keine Vorgabe erfolgt, gilt der Standardwert ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

Kennungen der Lernenden, die Zugriff auf die Kursaufgaben haben 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 oder Studenten zugewiesen.

submissionModificationMode

enum (SubmissionModificationMode)

Einstellung, um festzulegen, wann Schüler/Studenten Aufgaben bearbeiten dürfen. Wenn keine Vorgabe erfolgt, gilt der Standardwert MODIFIABLE_UNTIL_TURNED_IN.

creatorUserId

string

ID des Nutzers, der die Kursaufgaben erstellt hat.

Schreibgeschützt.

topicId

string

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

gradeCategory

object (GradeCategory)

Die Kategorie, der die Note dieser Kursaufgabe beiträgt. Nur präsentieren, wenn für die Kursaufgaben eine Kategorie 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 wird.

Union-Feld details. Zusätzliche Details, die sich speziell auf eine bestimmte 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 einem workType von MULTIPLE_CHOICE_QUESTION angegeben werden. Andernfalls darf es nicht festgelegt werden.

gradingPeriodId

string

ID des mit der Kursaufgabe verknüpften Benotungszeitraums.

  • Wenn keine Angabe gemacht wird, wird die ID des Benotungszeitraums basierend auf dueDate festgelegt (oder scheduledTime, wenn kein dueDate festgelegt ist).
  • Wenn Sie keine Verknüpfung mit einem Benotungszeitraum angeben möchten, setzen Sie dieses Feld auf einen leeren String („“).
  • Wenn sie angegeben wird, muss sie mit einer vorhandenen Benotungszeitraum-ID im Kurs übereinstimmen.

CourseWorkState

Die möglichen Status funktionieren natürlich.

Enums
COURSE_WORK_STATE_UNSPECIFIED Kein Status angegeben. Dies wird nie zurückgegeben.
PUBLISHED Status für veröffentlichte Arbeiten. Dies ist der Standardstatus.
DRAFT Status für noch nicht veröffentlichte Arbeiten. Aufgaben in diesem Status sind nur für Kursleiter und Domainadministratoren sichtbar.
DELETED Status für Aufgaben, die veröffentlicht wurden, aber jetzt gelöscht sind. Aufgaben in diesem Status sind nur für Kursleiter und Domainadministratoren sichtbar. Aufgaben 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 Beiträge können vor der Abgabe noch geändert werden.
MODIFIABLE Einreichungen können jederzeit geändert werden.

Assignment

Zusätzliche Details zu Zuweisungen.

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

object (DriveFolder)

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

MultipleChoiceQuestion

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

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

string

Mögliche Auswahlmöglichkeiten.

Methoden

create

Es werden Kursarbeiten erstellt.

delete

Löscht eine Kursaufgabe.

get

Gibt Kursarbeiten zurück.

getAddOnContext

Ruft die 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 die Zuweisung und die Optionen einer Kursaufgabe.

patch

Aktualisiert ein oder mehrere Felder einer Kursaufgabe.