REST Resource: courses.courseWorkMaterials

Zasób: CourseWorkMaterial

Materiał dotyczący zadań w ramach zajęć, utworzony 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 kursu.

Tylko do odczytu.
id

string

Przypisany przez Classroom identyfikator materiału z danego kursu, unikalny dla każdego kursu.

Tylko do odczytu.
title

string

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

string

Opcjonalny opis materiału z tego zadania. Tekst musi być prawidłowym ciągiem UTF-8 zawierającym nie więcej niż 30 tys. znaków.
materials[]

object (Material)

dodatkowe materiały;

Materiały do pracy na kursie nie mogą zawierać więcej niż 20 elementów.
state

enum (CourseWorkMaterialState)

Stan materiału do pracy z kursu. Jeśli nie podasz żadnej wartości, stan domyślny to DRAFT.
creationTime

string (Timestamp format)

Sygnatura czasowa utworzenia materiału z tego zadania.

Tylko do odczytu.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne 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 materiału z tego kursu.

Tylko do odczytu.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne 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, która wskazuje, kiedy zaplanowano opublikowanie materiału z zadania.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne 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 z zadania. Jeśli nie podasz żadnej opcji, domyślna wartość to ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

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

string

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

Tylko do odczytu.
topicId

string

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

CourseWorkMaterialState

Możliwe stany materiału do zadań

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

Metody

create

 Tworzy materiały do pracy z kursem.

delete

 Usuwa materiały z pracy domowej.

get

 Zwraca materiał z pracy domowej.

getAddOnContext

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

list

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

patch

 Zaktualizuje co najmniej 1 pole materiału z pracy zaliczeniowej.