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.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. 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 Kursarbeitsmaterial.

Schreibgeschützt.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. 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 geplanten Veröffentlichungstermin dieser Kursmaterialien.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

assigneeMode

enum (AssigneeMode)

Zugewiesener Modus des Kursmaterials. Wenn keine Angabe erfolgt, ist der Standardwert ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

IDs von Schülern/Studenten mit Zugriff auf die Kursmaterialien. Dieses Feld wird nur festgelegt, wenn assigneeMode INDIVIDUAL_STUDENTS ist. Wenn assigneeMode INDIVIDUAL_STUDENTS ist, können nur die in diesem Feld angegebenen Schüler/Studenten die Kursmaterialien sehen.

creatorUserId

string

Kennung für den Nutzer, der das Kursarbeitsmaterial 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 Kursmaterialien 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.