REST Resource: courses.courseWorkMaterials

Zasób: CourseWorkMaterial

Materiały do zajęć utworzone przez nauczyciela dla uczniów

Zapis JSON
{
  "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
}
Pola
courseId

string

Identyfikator szkolenia.

Tylko do odczytu.

id

string

Identyfikator materiału do zajęć przypisany przez Classroom, unikalny w ramach zajęć.

Tylko do odczytu.

title

string

Tytuł tego materiału do zadania. Tytuł musi być prawidłowym ciągiem znaków UTF-8 zawierającym od 1 do 3000 znaków.

description

string

Opcjonalny opis tego materiału do zajęć. Tekst musi być prawidłowym ciągiem znaków UTF-8 zawierającym nie więcej niż 30 000 znaków.

materials[]

object (Material)

Dodatkowe materiały.

Materiał do zajęć nie może zawierać więcej niż 20 elementów.

state

enum (CourseWorkMaterialState)

Stan tego materiału do zajęć. Jeśli nie określisz tu żadnej wartości, zostanie użyty stan domyślny DRAFT.

creationTime

string (Timestamp format)

Sygnatura czasowa utworzenia tego materiału do zajęć.

Tylko do odczytu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i używają 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Sygnatura czasowa ostatniej zmiany w tym materiale do zajęć.

Tylko do odczytu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i używają 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

scheduledTime

string (Timestamp format)

Opcjonalna sygnatura czasowa, kiedy materiał do zajęć ma zostać opublikowany.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i używają 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

assigneeMode

enum (AssigneeMode)

Tryb przypisania materiału do nauki. Jeśli nie podasz żadnej opcji, domyślną wartością będzie ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

Identyfikatory uczniów, którzy mają dostęp do materiałów z zajęć. To pole jest ustawiane tylko wtedy, gdy assigneeMode ma wartość INDIVIDUAL_STUDENTS. Jeśli assigneeMode ma wartość INDIVIDUAL_STUDENTS, materiał z zajęć mogą zobaczyć tylko uczniowie wymienieni w tym polu.

creatorUserId

string

Identyfikator użytkownika, który utworzył materiał do zajęć.

Tylko do odczytu.

topicId

string

Identyfikator tematu, z którym powiązany jest ten materiał do zajęć. Musi pasować do istniejącego tematu w kursie.

CourseWorkMaterialState

Możliwe stany materiałów do zajęć

Wartości w polu enum
COURSEWORK_MATERIAL_STATE_UNSPECIFIED Nie podano stanu. Nie jest on nigdy zwracany.
PUBLISHED Stan materiału do zajęć, który został opublikowany. Jest to stan domyślny.
DRAFT Stan materiału do zajęć, który nie został jeszcze opublikowany. Materiały do zajęć w tym stanie są widoczne tylko dla nauczycieli i administratorów domeny.
DELETED Stan materiału do zajęć, który został opublikowany, ale jest teraz usunięty. Materiały do zajęć w tym stanie są widoczne tylko dla nauczycieli i administratorów domeny. Materiały do zajęć w tym stanie są usuwane po pewnym czasie.

Metody

create

Tworzy materiał do zajęć.

delete

Usuwa materiał do zajęć.

get

Zwraca materiał do zajęć.

getAddOnContext

Pobiera metadane dodatków do Google Classroom w kontekście konkretnego posta.

list

Zwraca listę materiałów do zajęć, które osoba wysyłająca prośbę może wyświetlić.

patch

Aktualizuje co najmniej jedno pole materiału do zajęć.