REST Resource: courses.courseWork

Zasób: CourseWork

Zadanie utworzone przez nauczyciela dla uczniów uczestniczących w kursie.

Zapis JSON 
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },
  "previewVersion": enum (PreviewVersion),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "gradingPeriodId": string
}
Pola
courseId

string

Identyfikator kursu.

Tylko do odczytu.
id

string

Przypisany przez Classroom identyfikator zadania, unikalny w ramach kursu.

Tylko do odczytu.
title

string

Tytuł 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 zadania. Jeśli jest ustawiony, opis 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.

Zadanie nie może zawierać więcej niż 20 materiałów.
state

enum (CourseWorkState)

Stan tego zadania. Jeśli nie określono inaczej, domyślnym stanem jest DRAFT.
creationTime

string (Timestamp format)

Sygnatura czasowa określająca, kiedy zadanie zostało utworzone.

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 w tym zadaniu.

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".
dueDate

object (Date)

Opcjonalna data (w formacie UTC) terminu oddania zadania. Należy go określić, jeśli określono dueTime.
dueTime

object (TimeOfDay)

Opcjonalna godzina (w strefie czasowej UTC), do której należy przesłać zadanie. Należy go określić, jeśli określono dueDate.
scheduledTime

string (Timestamp format)

Opcjonalna sygnatura czasowa, kiedy to zadanie ma zostać opublikowane.

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".
maxPoints

number

Maksymalna ocena za to zadanie. Jeśli wartość wynosi 0 lub nie jest określona, projekt jest traktowany jako nieoceniany. Musi to być nieujemna liczba całkowita.
workType

enum (CourseWorkType)

Typ zadania.

Typ jest ustawiany podczas tworzenia zadania i nie można go zmienić.
associatedWithDeveloper

boolean

Określa, czy to zadanie jest powiązane z projektem w Konsoli programisty, który wysyła żądanie.

Więcej informacji znajdziesz na stronie courseWork.create.

Tylko do odczytu.
assigneeMode

enum (AssigneeMode)

Tryb przypisania materiałów do zajęć. Jeśli nie określono inaczej, wartość domyślna to ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

Identyfikatory uczniów, którzy mają dostęp do materiałów dydaktycznych. To pole jest ustawiane tylko wtedy, gdy assigneeMode ma wartość INDIVIDUAL_STUDENTS. Jeśli assigneeMode to INDIVIDUAL_STUDENTS, materiały dydaktyczne są przypisywane tylko uczniom określonym w tym polu.
submissionModificationMode

enum (SubmissionModificationMode)

Ustawienie określające, kiedy uczniowie mogą modyfikować przesłane zadania. Jeśli nie określono inaczej, wartość domyślna to MODIFIABLE_UNTIL_TURNED_IN.
creatorUserId

string

Identyfikator użytkownika, który utworzył materiały dydaktyczne.

Tylko do odczytu.
topicId

string

Identyfikator tematu, z którym są powiązane te materiały dydaktyczne. Musi pasować do istniejącego tematu w kursie.
gradeCategory

object (GradeCategory)

Kategoria, do której zalicza się ocena z tych materiałów dydaktycznych. Wyświetlane tylko wtedy, gdy dla materiałów dydaktycznych wybrano kategorię. Może być używana do obliczania oceny ogólnej.

Tylko do odczytu.
previewVersion

enum (PreviewVersion)

Tylko dane wyjściowe. Wersja testowa interfejsu API używana do pobierania tego zasobu.
learningGoals[]

object (LearningGoal)

Opcjonalnie:

Odniesienia do celów edukacyjnych dołączonych do tego zadania. Zadanie może mieć maksymalnie 10 celów edukacyjnych. To pole jest wypełniane tylko wtedy, gdy ustawiono odpowiednią opcję previewVersion.
Dodatkowe szczegóły dotyczące typu zadania. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
assignment

object (Assignment)

Szczegóły projektu. To pole jest wypełniane tylko wtedy, gdy workType ma wartość ASSIGNMENT.

Tylko do odczytu.
multipleChoiceQuestion

object (MultipleChoiceQuestion)

Szczegóły pytania jednokrotnego wyboru. W przypadku operacji odczytu to pole jest wypełniane tylko wtedy, gdy workType ma wartość MULTIPLE_CHOICE_QUESTION. W przypadku operacji zapisu to pole musi być określone podczas tworzenia zadania z workType o wartości MULTIPLE_CHOICE_QUESTION. W przeciwnym razie nie może być ustawione.
Koniec pól wykluczających się wzajemnie.
gradingPeriodId

string

Identyfikator okresu oceniania powiązanego z materiałami dydaktycznymi.

  • Jeśli podczas tworzenia nie określono identyfikatora okresu oceniania, zostanie on ustawiony na podstawie dueDate (lub scheduledTime, jeśli nie ustawiono dueDate).
  • Aby wskazać brak powiązania z jakimkolwiek okresem oceniania, ustaw to pole na pusty ciąg znaków ("").
  • Jeśli podano, musi odpowiadać identyfikatorowi istniejącego okresu oceniania na kursie.

CourseWorkState

Możliwe stany zadania.

Wartości w polu enum
COURSE_WORK_STATE_UNSPECIFIED Nie podano stanu. Ta wartość nigdy nie jest zwracana.
PUBLISHED Stan opublikowanego utworu. Jest to stan domyślny.
DRAFT Stan zadania, które nie zostało jeszcze opublikowane. Prace w tym stanie są widoczne tylko dla nauczycieli zajęć i administratorów domeny.
DELETED Stan pracy, która została opublikowana, ale została usunięta. Prace w tym stanie są widoczne tylko dla nauczycieli prowadzących zajęcia i administratorów domeny. Zadanie w tym stanie jest po pewnym czasie usuwane.

SubmissionModificationMode

Możliwe tryby modyfikacji zadań przesłanych przez uczniów.

Wartości w polu enum
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Nie określono trybu modyfikacji. Ta wartość nigdy nie jest zwracana.
MODIFIABLE_UNTIL_TURNED_IN Przesłane zadania można modyfikować przed ich oddaniem.
MODIFIABLE Przesłane treści można w każdej chwili zmienić.

Projekt

Dodatkowe informacje o projektach.

Zapis JSON 
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
Pola
studentWorkFolder

object (DriveFolder)

Folder na Dysku, w którym umieszczane są załączniki z prac przesłanych przez uczniów. Ta wartość jest wypełniana tylko w przypadku nauczycieli i administratorów zajęć.

MultipleChoiceQuestion

Dodatkowe informacje dotyczące pytań jednokrotnego wyboru.

Zapis JSON 
{
  "choices": [
    string
  ]
}
Pola
choices[]

string

Możliwe opcje.

Metody

create

 tworzenia zadań,

delete

 Usuwa zadanie.

get

 Zwraca zadanie.

getAddOnContext

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

list

 Zwraca listę zadań, które osoba wysyłająca żądanie może wyświetlić.

modifyAssignees

 Modyfikuje tryb i opcje przypisanej osoby w materiałach dydaktycznych.

patch

 Aktualizuje co najmniej jedno pole zadania.