REST Resource: courses.courseWorkMaterials

Ressource: CourseWorkMaterial

Kursmaterialien, die von einer Lehrkraft für die Schüler/Studenten des Kurses erstellt wurden

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

Kennung des Kurses.

Schreibgeschützt.

id

string

Die von Classroom zugewiesene Kennung dieses Kursmaterials, eindeutig pro Kurs.

Schreibgeschützt.

title

string

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

description

string

Optionale Beschreibung des Arbeitsmaterials für diesen Kurs. Der Text muss ein gültiger UTF-8-String mit maximal 30.000 Zeichen sein.

materials[]

object (Material)

Zusätzliche Materialien

Ein Kursmaterial darf maximal 20 Materialelemente enthalten.

state

enum (CourseWorkMaterialState)

Status des Arbeitsmaterials für diesen Kurs. Wenn keine Angabe erfolgt, ist der Standardstatus DRAFT.

creationTime

string (Timestamp format)

Zeitstempel für den Zeitpunkt, zu dem dieses Kursarbeitsmaterial 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 diesem Kursarbeitsmaterial.

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

scheduledTime

string (Timestamp format)

Optionaler Zeitstempel für den geplanten Veröffentlichungstermin dieser Kursmaterialien.

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

assigneeMode

enum (AssigneeMode)

Zugewiesener Modus des Kursmaterials. 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, können nur die in diesem Feld angegebenen Schüler oder Studenten das Kursmaterial sehen.

creatorUserId

string

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

Schreibgeschützt.

topicId

string

Kennung für das Thema, dem dieses Kursarbeitsmaterial zugeordnet ist. Muss mit einem vorhandenen Thema im Kurs übereinstimmen.

CourseWorkMaterialState

Mögliche Status von Kursmaterialien

Enums
COURSEWORK_MATERIAL_STATE_UNSPECIFIED Kein Status angegeben. Dieser Wert wird nie zurückgegeben.
PUBLISHED Status für veröffentlichtes Kursmaterial. Das ist der Standardstatus.
DRAFT Status für Kursmaterialien, die noch nicht veröffentlicht wurden. Kursmaterialien in diesem Status sind nur für Kursleiter und Domainadministratoren sichtbar.
DELETED Status für Kursmaterialien, die veröffentlicht, aber jetzt gelöscht wurden. Kursmaterialien in diesem Status sind nur für Kursleiter und Domainadministratoren sichtbar. Kursmaterialien in diesem Status werden nach einiger Zeit gelöscht.

Methoden

create

Erstellt ein Kursarbeitsmaterial.

delete

Löscht ein Kursarbeitsmaterial.

get

Gibt ein Kursarbeitsmaterial zurück.

getAddOnContext

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

list

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

patch

Aktualisiert ein oder mehrere Felder eines Kursarbeitsmaterials.