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 znaków 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 określisz tego ustawienia, zostanie użyta wartość domyślna DRAFT.

creationTime

string (Timestamp format)

Sygnatura czasowa utworzenia materiału.

Tylko do odczytu.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Sygnatura czasowa ostatniej zmiany materiału z tego kursu.

Tylko do odczytu.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

scheduledTime

string (Timestamp format)

Opcjonalna sygnatura czasowa, która wskazuje, kiedy zaplanowano opublikowanie materiału z zadania.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

assigneeMode

enum (AssigneeMode)

Tryb przypisany do 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 wartość 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 opublikowanych materiałów dotyczących zadań. 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 domowej.