Verwenden Ihre Nutzer Classroom mit Google Meet? Sehen Sie sich die Apps Script-Kurzanleitung zum Ansehen der Teilnahme von Schülern/Studenten in Google Meet-Kursen an.

REST Resource: courses.courseWork

Ressource: Kursarbeit

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

Von Classroom zugewiesene ID für diese Kursaufgabe. Eindeutige Kennung für jeden Kurs.

Schreibgeschützt.

title

string

Titel der Kursaufgabe. Der Titel muss ein gültiger UTF-8-String mit 1 bis 3.000 Zeichen sein.

description

string

Optionale Beschreibung der Kursarbeiten. Wenn festgelegt, muss die Beschreibung ein gültiger UTF-8-String mit maximal 30.000 Zeichen sein.

materials[]

object (Material)

Zusätzliches Material.

Kursarbeit darf nicht mehr als 20 Materialien enthalten.

state

enum (CourseWorkState)

Status dieses Kurses. Wenn keine Vorgabe erfolgt, gilt der Standardstatus DRAFT.

creationTime

string (Timestamp format)

Zeitstempel für die Erstellung der Kursaufgabe.

Schreibgeschützt.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit einer Auflösung von Nanosekunden 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 diesem Kurs.

Schreibgeschützt.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit einer Auflösung von Nanosekunden 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 Aufgaben für diesen Kurs fällig sind Dies muss angegeben werden, wenn dueTime angegeben ist.

dueTime

object (TimeOfDay)

Optionale Tageszeit in UTC, zu der die Aufgaben für diesen Kurs fällig sind Dies muss angegeben werden, wenn dueDate angegeben ist.

scheduledTime

string (Timestamp format)

Optionaler Zeitstempel für die Veröffentlichung der Kursarbeiten.

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

maxPoints

number

Maximale Note für diese Kursaufgabe. Wenn der Wert null oder nicht angegeben ist, gilt diese 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 Kursaufgabe mit dem Entwicklerkonsolenprojekt verknüpft ist, von dem die Anfrage stammt.

Unter courseWork.create finden Sie weitere Informationen.

Schreibgeschützt.

assigneeMode

enum (AssigneeMode)

Zuständiger Modus für die Kursaufgabe. Wenn keine Vorgabe erfolgt, gilt der Standardwert ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

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

submissionModificationMode

enum (SubmissionModificationMode)

Einstellung, mit der festgelegt wird, wann Schüler und Studenten Beiträge bearbeiten dürfen. Wenn keine Vorgabe erfolgt, gilt der Standardwert MODIFIABLE_UNTIL_TURNED_IN.

creatorUserId

string

ID des Nutzers, der die Kursaufgabe 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, zu der die Note dieser Kursaufgabe beiträgt. Nur präsentieren, wenn eine Kategorie für die Kursaufgabe ausgewählt wurde. Kann zur Berechnung der Gesamtnote verwendet werden.

Schreibgeschützt.

Union-Feld details. Zusätzliche Details zu einem Kurstyp. 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 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 einem workType von MULTIPLE_CHOICE_QUESTION angegeben werden. Ansonsten darf es nicht festgelegt werden.

Kursarbeitsstatus

Mögliche Status der Arbeit.

Enums
COURSE_WORK_STATE_UNSPECIFIED Kein Status angegeben. Das wird nie zurückgegeben.
PUBLISHED Status für veröffentlichte Arbeiten. Das ist der Standardzustand.
DRAFT Status für noch nicht veröffentlichte Arbeiten. Aufgaben in diesem Status sind nur für Lehrkräfte und Kursadministratoren sichtbar.
DELETED Status für veröffentlichte Arbeiten, die jetzt gelöscht wurden. Aufgaben in diesem Status sind nur für Lehrkräfte und Kursadministratoren sichtbar. Aufgaben mit diesem Status werden nach einiger Zeit gelöscht.

Datum

Stellt ein ganzes oder teilweises Kalenderdatum dar, z. B. einen Geburtstag. Tageszeit und Zeitzone sind entweder an anderer Stelle angegeben oder unbedeutend. Das Datum bezieht sich auf den gregorianischen Kalender. Das kann Folgendes sein:

  • Ein vollständiges Datum mit Werten für Jahr, Monat und Tag ungleich null.
  • Ein Monat und ein Tag mit einem Jahr von null, z. B. ein Jahrestag.
  • Ein Jahr für sich – mit 0 Monaten und 0 Tagen
  • Ein Jahr und ein Monat mit einem null Tag (z. B. ein Ablaufdatum einer Kreditkarte)

Ähnliche Typen:

JSON-Darstellung
{
  "year": integer,
  "month": integer,
  "day": integer
}
Felder
year

integer

Jahr des Datums. Der Wert muss zwischen 1 und 9999 oder 0 liegen, wenn ein Datum ohne Jahr angegeben werden soll.

month

integer

Monat eines Jahres. Der Wert muss zwischen 1 und 12 oder 0 liegen, damit ein Jahr ohne Monat und Tag angegeben werden kann.

day

integer

Tag eines Monats. Der Wert muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Sie kann auch 0 sein, um nur ein Jahr oder ein Jahr und einen Monat anzugeben, bei denen der Tag keine Bedeutung hat.

TimeOfDay

Stellt eine Tageszeit dar. Das Datum und die Zeitzone sind entweder nicht relevant oder werden an anderer Stelle angegeben. Eine API kann Schaltsekunden zulassen. Vergleichbare Typen sind google.type.Date und google.protobuf.Timestamp.

JSON-Darstellung
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Felder
hours

integer

Stunden im 24-Stunden-Format. Sollte zwischen 0 und 23 liegen. Eine API kann den Wert "24:00:00" für Szenarien wie Geschäftsschlusszeit zulassen.

minutes

integer

Minuten der Zeitangabe. Muss zwischen 0 und 59 liegen.

seconds

integer

Sekunden der Zeitangabe. Muss normalerweise zwischen 0 und 59 liegen. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt.

nanos

integer

Sekundenbruchteile in Nanosekunden. Muss zwischen 0 und 999.999.999 liegen.

Modus der Einreichungsänderung

Mögliche Änderungsmodi für abgegebene Aufgaben

Enums
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Kein Änderungsmodus angegeben. Das wird nie zurückgegeben.
MODIFIABLE_UNTIL_TURNED_IN Beiträge können vor ihrer 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)

Drive-Ordner, in dem Anhänge aus abgegebenen Aufgaben gespeichert werden Das Feld ist nur für Lehrkräfte und Administratoren des Kurses ausgefüllt.

Multiple-Choice-Frage

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

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

string

Mögliche Auswahlmöglichkeiten.

Methoden

create

Erstellt Kursarbeiten.

delete

Löscht eine Kursaufgabe.

get

Gibt die Kursaufgabe zurück.

list

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

modifyAssignees

Ändert den Modus der zuständigen Person und die Optionen einer Kursaufgabe.

patch

Aktualisiert ein oder mehrere Felder einer Kursaufgabe.