REST Resource: courses.courseWorkMaterials

Ressource: CourseWorkMaterial

Kursmaterial, das von einer Lehrkraft für die Lernenden erstellt wurde

JSON-Darstellung
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkMaterialState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "scheduledTime": string,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "creatorUserId": string,
  "topicId": string
}
Felder
courseId

string

ID des Kurses.

Schreibgeschützt.

id

string

Die von Classroom zugewiesene ID dieses Kursmaterials, die pro Kurs eindeutig ist.

Schreibgeschützt.

title

string

Titel dieses Arbeitsmaterials zum Kurs. Der Titel muss ein gültiger UTF-8-String mit 1 bis 3.000 Zeichen sein.

description

string

Optionale Beschreibung dieses Kursmaterials. Der Text muss ein gültiger UTF-8-String mit maximal 30.000 Zeichen sein.

materials[]

object (Material)

Zusätzliche Materialien.

Ein Arbeitsmaterial des Kurses darf nicht mehr als 20 Materialelemente enthalten.

state

enum (CourseWorkMaterialState)

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

creationTime

string (Timestamp format)

Zeitstempel für den Zeitpunkt, zu dem das Arbeitsmaterial des Kurses 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 diesem Kursmaterial.

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

scheduledTime

string (Timestamp format)

Optionaler Zeitstempel für den Zeitpunkt, zu dem die Veröffentlichung dieses Kursmaterials 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".

assigneeMode

enum (AssigneeMode)

Modus für zugewiesene Personen des Kurs-Arbeitsmaterials. Wenn keine Vorgabe erfolgt, gilt der Standardwert ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

IDs der Lernenden mit Zugriff auf die Arbeitsmaterialien des Kurses. Dieses Feld wird nur festgelegt, wenn assigneeMode den Wert INDIVIDUAL_STUDENTS hat. Wenn assigneeMode auf INDIVIDUAL_STUDENTS gesetzt ist, können nur in diesem Feld angegebene Schüler und Studenten das Arbeitsmaterial des Kurses sehen.

creatorUserId

string

Kennung des Nutzers, der das Kursmaterial erstellt hat.

Schreibgeschützt.

topicId

string

ID für das Thema, mit dem dieses Kursmaterial verknüpft ist. Muss mit einem vorhandenen Thema im Kurs übereinstimmen.

CourseWorkMaterialState

Mögliche Status von Kursmaterialien

Enums
COURSEWORK_MATERIAL_STATE_UNSPECIFIED Kein Bundesstaat angegeben. Dies wird nie zurückgegeben.
PUBLISHED Status des veröffentlichten Kursmaterials. Dies ist der Standardstatus.
DRAFT Status für ein Arbeitsmaterial des Kurses, das noch nicht veröffentlicht wurde. Material für Kursarbeiten mit diesem Status ist nur für Kurslehrer und Domainadministratoren sichtbar.
DELETED Status für Kursarbeiten, die veröffentlicht, aber jetzt gelöscht wurden. Material für Kursarbeiten mit diesem Status ist nur für Kurslehrer und Domainadministratoren sichtbar. Kursmaterialien mit diesem Status werden nach einiger Zeit gelöscht.

Methoden

create

Es erstellt ein Arbeitsmaterial für den Kurs.

delete

Löscht ein Arbeitsmaterial des Kurses.

get

Gibt ein Arbeitsmaterial zum Kurs zurück.

getAddOnContext

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

list

Gibt eine Liste mit Kursmaterialien zurück, die der Anforderer anzeigen darf.

patch

Aktualisiert ein oder mehrere Felder eines Kursmaterials.