REST Resource: courses.courseWorkMaterials

Ressource: CourseWorkMaterial

Kursmaterial, das von einer Lehrkraft für die Schüler/Studenten des Kurses 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 Kennung dieses Kursmaterials, die für jeden 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 darf nicht mehr als 20 Materialien enthalten.

state

enum (CourseWorkMaterialState)

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

creationTime

string (Timestamp format)

Zeitstempel für die Erstellung dieses Kursarbeitsmaterials.

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 die geplante Veröffentlichung dieses Kursmaterials.

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)

Modus „Zugewiesene Person“ des Kursarbeitsmaterials. Wenn keine Vorgabe erfolgt, gilt der Standardwert ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

Kennungen von Schülern/Studenten, die Zugriff auf das Arbeitsmaterial des Kurses haben Dieses Feld wird nur festgelegt, wenn assigneeMode den Wert INDIVIDUAL_STUDENTS hat. Wenn assigneeMode den Wert INDIVIDUAL_STUDENTS hat, können nur in diesem Feld angegebene Schüler oder Studenten das Arbeitsmaterial sehen.

creatorUserId

string

ID des Nutzers, der das Kursmaterial erstellt hat.

Schreibgeschützt.

topicId

string

Kennzeichnung des Themas, mit dem dieses Kursmaterial verknüpft ist. Muss mit einem vorhandenen Thema im Kurs übereinstimmen.

CourseWorkMaterialState

Mögliche Status des Kursmaterials

Enums
COURSEWORK_MATERIAL_STATE_UNSPECIFIED Kein Status angegeben. Dies wird nie zurückgegeben.
PUBLISHED Status für veröffentlichte Kursarbeiten. Dies ist der Standardstatus.
DRAFT Status für ein noch nicht veröffentlichtes Kursmaterial. Kursmaterial mit diesem Status ist nur für Lehrkräfte und Domainadministratoren sichtbar.
DELETED Status für Kursarbeiten, die veröffentlicht wurden, aber jetzt gelöscht sind. Kursmaterial mit diesem Status ist nur für Lehrkräfte und Domainadministratoren sichtbar. Kursmaterial mit diesem Status wird nach einiger Zeit gelöscht.

Methoden

create

Es wird ein Arbeitsmaterial zum Kurs erstellt.

delete

Löscht ein Arbeitsmaterial.

get

Gibt ein Arbeitsmaterial zurück.

getAddOnContext

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

list

Gibt eine Liste von Kursmaterial zurück, das der Anforderer ansehen darf.

patch

Aktualisiert ein oder mehrere Felder eines Kursarbeitsmaterials.