REST Resource: courses.courseWork

Ressource: CourseWork

Von einer Lehrkraft für die Schüler/Studenten des Kurses erstellte Kursaufgaben.

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

Die von Classroom zugewiesene Kennung dieser Kursarbeit, eindeutig pro Kurs.

Schreibgeschützt.
title

string

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

string

Optionale Beschreibung dieser Kursarbeit. 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

Kursmaterialien dürfen nicht mehr als 20 Materialien enthalten.
state

enum (CourseWorkState)

Status dieser Kursarbeit. Wenn keine Angabe erfolgt, ist der Standardstatus DRAFT.
creationTime

string (Timestamp format)

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

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

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

object (TimeOfDay)

Optionale Uhrzeit in UTC, zu der die Abgabe für diese Kursarbeit fällig ist. Muss angegeben werden, wenn dueDate angegeben ist.
scheduledTime

string (Timestamp format)

Optionaler Zeitstempel für den geplanten Veröffentlichungszeitpunkt dieser Kursarbeit.

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

Die Höchstnote für diese Kursarbeit. Wenn der Wert „0“ oder nicht angegeben ist, gilt die Aufgabe als unbenotet. Dies muss eine nicht negative Ganzzahl sein.
workType

enum (CourseWorkType)

Art dieser Kursarbeit.

Der Typ wird beim Erstellen der Kursarbeit 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)

Modus der zugewiesenen Kursarbeit. Wenn keine Angabe erfolgt, beträgt der Standardwert ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

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

enum (SubmissionModificationMode)

Einstellung, mit der festgelegt wird, wann Schüler/Studenten ihre Einreichungen ändern dürfen. Wenn keine Angabe erfolgt, beträgt der Standardwert MODIFIABLE_UNTIL_TURNED_IN.
creatorUserId

string

Kennung für den Nutzer, der die Kursarbeit erstellt hat.

Schreibgeschützt.
topicId

string

Kennung für das Thema, mit dem diese Kursarbeit 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 für die Kursarbeit 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.
Union-Feld details. Zusätzliche Details, die für eine Art von Kursarbeit spezifisch sind. 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 ASSIGNMENT ist.

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 Kursarbeiten mit einer workType von MULTIPLE_CHOICE_QUESTION angegeben werden. Andernfalls darf es nicht festgelegt werden.
gradingPeriodId

string

Kennung des Benotungszeitraums, der mit dem Kurs verknüpft ist.

  • Wenn keine Angabe erfolgt, wird die Benotungszeitraum-ID basierend auf dueDate festgelegt (oder scheduledTime, wenn keine dueDate festgelegt ist).
  • Wenn die Aufgabe keiner Benotungszeit zugeordnet ist, geben Sie in diesem Feld einen leeren String („"") ein.
  • 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. Dieser Wert wird nie zurückgegeben.
PUBLISHED Status für veröffentlichte Inhalte. Das ist der Standardstatus.
DRAFT Status für noch nicht veröffentlichte Inhalte. In diesem Status sind die Inhalte nur für Kursleiter und Domainadministratoren sichtbar.
DELETED Status für ein Werk, das veröffentlicht, aber jetzt gelöscht wurde. In diesem Status sind die Inhalte nur für Kursleiter und Domainadministratoren sichtbar. Arbeiten in diesem Status werden nach einiger Zeit gelöscht.

SubmissionModificationMode

Mögliche Modifikationsmodi für die Einreichungen von Schülern/Studenten.

Enums
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Es wurde kein Änderungsmodus angegeben. Dieser Wert wird nie zurückgegeben.
MODIFIABLE_UNTIL_TURNED_IN Einreichungen können vor der Abgabe geändert werden.
MODIFIABLE Einreichungen 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 den Einreichungen von Schülern/Studenten abgelegt werden. Dieser Wert wird nur für Lehrkräfte und Administratoren eines Kurses ausgefüllt.

MultipleChoiceQuestion

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

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

string

Mögliche Optionen

Methoden

create

 Erstellt Kursaufgaben.

delete

 Löscht eine Kursarbeit.

get

 Gibt Kursaufgaben 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 Antragsteller ansehen darf.

modifyAssignees

 Ändert den Zuweisungsmodus und die Optionen eines Kurses.

patch

 Aktualisiert ein oder mehrere Felder einer Kursarbeit.