REST Resource: courses.courseWork

Zasób: CourseWork

Zadania utworzone przez nauczyciela dla uczniów na danym 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),

  // Union field details can be only one of the following:
  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  // End of list of possible types for union field details.
  "gradingPeriodId": string
}
Pola
courseId

string

Identyfikator zajęć.

Tylko do odczytu.

id

string

Przypisany przez Classroom identyfikator tych zadań na zajęciach, niepowtarzalny dla poszczególnych zajęć.

Tylko do odczytu.

title

string

Tytuł tego szkolenia. Tytuł musi być prawidłowym ciągiem znaków UTF-8 i zawierać 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 i zawierać nie więcej niż 30 000 znaków.

materials[]

object (Material)

Dodatkowe materiały

CourseWork może zawierać nie więcej niż 20 elementów materiałowych.

state

enum (CourseWorkState)

Stan tego zadania. Jeśli stan nie jest określony, domyślny to DRAFT.

creationTime

string (Timestamp format)

Sygnatura czasowa utworzenia tego zadania.

Tylko do odczytu.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu” z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Sygnatura czasowa ostatniej zmiany w tym kursie.

Tylko do odczytu.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu” z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

dueDate

object (Date)

Opcjonalny termin (według czasu UTC) określający termin nadsyłania zadań w ramach tego kursu. Musisz go podać, jeśli podano dueTime.

dueTime

object (TimeOfDay)

Opcjonalnie: godzina (w strefie czasowej UTC) oznacza termin przesyłania zadań w ramach tego kursu. Musisz go podać, jeśli podano dueDate.

scheduledTime

string (Timestamp format)

Opcjonalna sygnatura czasowa zaplanowanej publikacji zadania w ramach kursu.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu” z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

maxPoints

number

Maksymalna ocena za to zadanie. Jeśli ten projekt nie zostanie określony lub nie zostanie określony, zostanie uznany za bez oceny. Musi to być nieujemna liczba całkowita.

workType

enum (CourseWorkType)

Typ tego kursu.

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

associatedWithDeveloper

boolean

Określa, czy ten element roboczy szkolenia jest powiązany z projektem w Konsoli programisty wysyłającym żądanie.

Aby dowiedzieć się więcej, wejdź na courseWork.create.

Tylko do odczytu.

assigneeMode

enum (AssigneeMode)

Tryb przypisanej osoby zadania. Jeśli wartość nie została określona, przyjmuje się wartość domyślną ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

Identyfikatory uczniów z dostępem do zadania. To pole jest ustawione tylko wtedy, gdy assigneeMode ma wartość INDIVIDUAL_STUDENTS. Jeśli assigneeMode ma wartość INDIVIDUAL_STUDENTS, tylko uczniowie wskazani w tym polu otrzymają zadanie.

submissionModificationMode

enum (SubmissionModificationMode)

Ustawienie określające, kiedy uczniowie mogą modyfikować przesłane zadania. Jeśli wartość nie została określona, przyjmuje się wartość domyślną MODIFIABLE_UNTIL_TURNED_IN.

creatorUserId

string

Identyfikator użytkownika, który utworzył zadanie.

Tylko do odczytu.

topicId

string

Identyfikator tematu, z którym jest powiązane to szkolenie. Musi pasować do istniejącego tematu w kursie.

gradeCategory

object (GradeCategory)

Kategoria, do której składa się ocena tego zadania. Widoczny tylko wtedy, gdy dla danego zadania wybrano kategorię. Może zostać użyta do obliczenia oceny ogólnej.

Tylko do odczytu.

previewVersion

enum (PreviewVersion)

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

Pole sumy details. Dodatkowe informacje specyficzne dla danego typu zadania. details może mieć tylko jedną z tych wartości:
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 użyciem pola workType o wartości MULTIPLE_CHOICE_QUESTION. Nie należy ono ustawiać go w inny sposób.

gradingPeriodId

string

Identyfikator okresu oceniania powiązanego z zadaniem.

  • Jeśli nie określono identyfikatora okresu oceniania, zostanie on ustawiony na podstawie atrybutu dueDate (lub scheduledTime, jeśli nie ustawiono elementu dueDate).
  • Aby wskazać, że nie masz powiązania z żadnym okresem oceniania, ustaw w tym polu pusty ciąg znaków („”).
  • Jeśli został określony, musi odpowiadać identyfikatorowi okresu oceniania obowiązującemu w danych zajęć.

CourseWorkState

Możliwe stany oczywiście działają.

Wartości w polu enum
COURSE_WORK_STATE_UNSPECIFIED Nie określono stanu. Nigdy nie jest zwracany.
PUBLISHED Stan opublikowanej pracy. Jest to stan domyślny.
DRAFT Stan zadania, które nie zostało jeszcze opublikowane. Zadania w tym stanie są widoczne tylko dla nauczycieli prowadzących zajęcia i administratorów domeny.
DELETED Stan zadania, które zostało opublikowane, ale zostało usunięte. Zadania w tym stanie są widoczne tylko dla nauczycieli prowadzących zajęcia i administratorów domeny. Praca w tym stanie zostanie po pewnym czasie usunięta.

SubmissionModificationMode

Możliwe tryby modyfikacji prac uczniów.

Wartości w polu enum
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Nie określono trybu modyfikacji. Nigdy nie jest zwracany.
MODIFIABLE_UNTIL_TURNED_IN Przesłane zadania można modyfikować przed oddaniem.
MODIFIABLE Przesłane pliki można w każdej chwili modyfikować.

Projekt

Dodatkowe informacje o projektach.

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

object (DriveFolder)

Folder na Dysku, w którym znajdują się załączniki od uczniów. To pole jest wypełniane tylko w przypadku nauczycieli i administratorów.

MultipleChoiceQuestion

Dodatkowe informacje w przypadku pytań jednokrotnego wyboru.

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

string

Możliwe opcje.

Metody

create

Tworzy zadania w ramach kursu.

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 zgłaszająca prośbę może wyświetlić.

modifyAssignees

Modyfikuje tryb przypisanych osób i opcje zadania.

patch

Aktualizuje co najmniej jedno pole zadania.