REST Resource: courses.courseWorkMaterials

Ressource: CourseWorkMaterial

Von einer Lehrkraft für die Schüler oder Studenten des Kurses erstelltes Kursmaterial

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

Von Classroom zugewiesene Kennung für dieses Kursmaterial, die für jeden Kurs eindeutig ist.

Schreibgeschützt.

title

string

Titel dieses Kursarbeitsmaterials. 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 Kursarbeitsmaterial darf maximal 20 Materialelemente enthalten.

state

enum (CourseWorkMaterialState)

Status dieses Kursmaterials. Wenn nicht angegeben, ist der Standardstatus DRAFT.

creationTime

string (Timestamp format)

Zeitstempel für den Zeitpunkt, zu dem dieses Kursmaterial erstellt wurde.

Schreibgeschützt.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Zeitstempel der letzten Änderung an diesem Kursmaterial.

Schreibgeschützt.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

scheduledTime

string (Timestamp format)

Optionaler Zeitstempel für den Zeitpunkt, zu dem dieses Kursmaterial veröffentlicht werden soll.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

assigneeMode

enum (AssigneeMode)

Zuweisungsmodus des Kursmaterials. Wenn nicht angegeben, ist der Standardwert ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

Kennungen von Schülern/Studenten, die Zugriff auf die Kursmaterialien haben. Dieses Feld wird nur festgelegt, wenn assigneeMode INDIVIDUAL_STUDENTS ist. Wenn assigneeMode auf INDIVIDUAL_STUDENTS gesetzt ist, können nur die in diesem Feld angegebenen Schüler und Studenten das Kursmaterial sehen.

creatorUserId

string

Kennung für den Nutzer, der das Kursmaterial erstellt hat.

Schreibgeschützt.

topicId

string

Kennung für das Thema, dem dieses Kursmaterial 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 Kursaufgabenmaterial, das veröffentlicht wurde. Dies ist der Standardstatus.
DRAFT Status für eine Kursaufgabe, die noch nicht veröffentlicht wurde. Kursarbeitsmaterial in diesem Status ist nur für Kursleiter und Domainadministratoren sichtbar.
DELETED Status für Kursmaterial, das veröffentlicht, aber jetzt gelöscht wurde. Kursarbeitsmaterial in diesem Status ist 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 Kursmaterial.

get

Gibt ein Kursarbeitsmaterial zurück.

getAddOnContext

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

list

Gibt eine Liste mit Kursmaterial zurück, das der Antragsteller ansehen darf.

patch

Aktualisiert ein oder mehrere Felder eines Kursmaterials.