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,
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ]
}
Pola
courseId

string

Identyfikator zajęć.

Tylko do odczytu.

id

string

Identyfikator tego materiału do zajęć przypisany przez Classroom, unikalny dla każdych zajęć.

Tylko do odczytu.

title

string

Tytuł tego materiału do zajęć. 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 stanu, domyślnie będzie to 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 zawierają 0, 3, 6 lub 9 cyfr po przecinku. 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 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 zawierają 0, 3, 6 lub 9 cyfr po przecinku. 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 ten 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 zawierają 0, 3, 6 lub 9 cyfr po przecinku. 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 przypisywania materiału do zajęć. Jeśli nie określisz trybu, domyślnie będzie to ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

Identyfikatory uczniów, którzy mają dostęp do materiału do zajęć. To pole jest ustawiane tylko wtedy, gdy assigneeMode ma wartość INDIVIDUAL_STUDENTS. Jeśli assigneeMode ma wartość INDIVIDUAL_STUDENTS, materiał do zajęć będzie widoczny tylko dla uczniów określonych w tym polu.

creatorUserId

string

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

Tylko do odczytu.

topicId

string

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

learningGoals[]

object (LearningGoal)

Opcjonalnie.

Odwołania do celów edukacyjnych dołączonych do tego materiału do zajęć. Materiał do zajęć może mieć maksymalnie 10 celów edukacyjnych. To pole jest wypełniane tylko wtedy, gdy ustawiona jest odpowiednia wartość previewVersion.

CourseWorkMaterialState

Możliwe stany materiału do zajęć

Wartości w polu enum
COURSEWORK_MATERIAL_STATE_UNSPECIFIED Nie określono stanu. Ta wartość nigdy nie jest zwracana.
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ł do zajęć w tym stanie jest widoczny tylko dla nauczycieli prowadzących zajęcia i administratorów domeny.
DELETED Stan materiału do zajęć, który został opublikowany, ale teraz jest usunięty. Materiał do zajęć w tym stanie jest widoczny tylko dla nauczycieli prowadzących zajęcia i administratorów domeny. Materiał do zajęć w tym stanie zostanie po pewnym czasie usunięty.

Metody

create

Tworzy materiał do zajęć.

delete

Usuwa materiał do zajęć.

get

Zwraca materiał do zajęć.

getAddOnContext

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

list

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

patch

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