REST Resource: courses.courseWork

Zasób: CourseWork

Zadania na zajęcia utworzone przez nauczyciela dla uczniów.

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 kursu.

Tylko do odczytu.

id

string

Przypisany przez Classroom identyfikator tego zadania, unikalny dla każdego kursu.

Tylko do odczytu.

title

string

Tytuł zadania z tego kursu. 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 pracy zaliczeniowej. Jeśli jest ustawiony, opis 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 dydaktyczne w ramach kursu nie mogą zawierać więcej niż 20 elementów.

state

enum (CourseWorkState)

Stan pracy nad tym kursem. Jeśli nie określisz tego ustawienia, zostanie użyta wartość domyślna DRAFT.

creationTime

string (Timestamp format)

Sygnatura czasowa utworzenia tego zadania.

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)

Znak czasu ostatniej zmiany w tym projekcie 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".

dueDate

object (Date)

Opcjonalna data w formacie UTC, do której należy przesłać pracę związaną z tym kursem. Jeśli podano wartość dueTime, musisz podać tę wartość.

dueTime

object (TimeOfDay)

Opcjonalna pora dnia (wg czasu UTC), do której należy przesłać projekty w ramach tego kursu. Jeśli podano wartość dueDate, musisz podać tę wartość.

scheduledTime

string (Timestamp format)

Opcjonalna sygnatura czasowa, która określa, kiedy zadanie ma zostać opublikowane.

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

maxPoints

number

Maksymalna ocena za to zadanie. Jeśli wartość jest równa 0 lub nie jest określona, projekt jest uważany za nieoceniony. Musi być nieujemną liczbą całkowitą.

workType

enum (CourseWorkType)

Typ zadania.

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

associatedWithDeveloper

boolean

Określa, czy ten element projektu kursu jest powiązany z projektem w Konsoli programistów, który wysyła żądanie.

Więcej informacji znajdziesz w artykule courseWork.create.

Tylko do odczytu.

assigneeMode

enum (AssigneeMode)

Tryb przypisany do osoby, która ma dostęp do kursu. Jeśli nie podasz żadnej opcji, domyślna wartość to ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

Identyfikatory uczniów, którzy mają dostęp do zajęć. To pole jest ustawiane tylko wtedy, gdy assigneeMode ma wartość INDIVIDUAL_STUDENTS. Jeśli wartość pola assigneeMode to INDIVIDUAL_STUDENTS, zadanie jest przypisane tylko do uczniów wymienionych w tym polu.

submissionModificationMode

enum (SubmissionModificationMode)

Ustawienie określające, kiedy uczniowie mogą modyfikować przesłane treści. Jeśli nie podasz żadnej opcji, domyślna wartość 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 powiązane są zajęcia. Musi pasować do istniejącego tematu w kursie.

gradeCategory

object (GradeCategory)

Kategoria, do której wliczana jest ocena z tego kursu. Wyświetla się tylko wtedy, gdy wybrano kategorię dla zajęć. Może być używany do obliczania ogólnej oceny.

Tylko do odczytu.

previewVersion

enum (PreviewVersion)

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

Pole unii details. dodatkowe informacje dotyczące konkretnego typu pracy zaliczeniowej; details może być tylko jednym z tych elementów:
assignment

object (Assignment)

Szczegóły projektu. 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 pracy zaliczeniowej z workType MULTIPLE_CHOICE_QUESTION, a w innych przypadkach nie może być ustawione.

gradingPeriodId

string

Identyfikator okresu oceniania powiązanego z kursem.

  • Jeśli nie zostanie podany, identyfikator okresu oceniania zostanie ustawiony na podstawie wartości dueDate (lub scheduledTime, jeśli nie ustawiono wartości dueDate).
  • Aby wskazać brak powiązania z okresem oceniania, ustaw to pole jako pusty ciąg znaków ("").
  • Jeśli jest podany, musi być zgodny z istniejącym identyfikatorem okresu oceniania w kursie.

CourseWorkState

Możliwe stany zadań z zajęć.

Wartości w polu enum
COURSE_WORK_STATE_UNSPECIFIED Nie podano stanu. Ten parametr nigdy nie jest zwracany.
PUBLISHED Stan opublikowanego utworu. Jest to stan domyślny.
DRAFT Stan projektu, który nie został jeszcze opublikowany. W tym stanie praca jest widoczna tylko dla nauczycieli i administratorów domeny.
DELETED Stan pracy, która została opublikowana, ale została teraz usunięta. W tym stanie praca jest widoczna tylko dla nauczycieli i administratorów domeny. Po pewnym czasie praca w tym stanie jest usuwana.

SubmissionModificationMode

Możliwe tryby modyfikacji prac uczniów.

Wartości w polu enum
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Nie wybrano trybu modyfikacji. Ten parametr nigdy nie jest zwracany.
MODIFIABLE_UNTIL_TURNED_IN Przed przesłaniem możesz zmodyfikować przesłane dane.
MODIFIABLE Możesz je zmienić w dowolnym momencie.

Projekt

dodatkowe informacje o projektach;

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

object (DriveFolder)

Folder na Dysku, w którym znajdują się załączniki przesłane przez uczniów. Ta sekcja jest wypełniana tylko w przypadku nauczycieli i administratorów kursu.

MultipleChoiceQuestion

dodatkowe informacje dotyczące pytań jednokrotnego wyboru;

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

string

Możliwe opcje

Metody

create

tworzyć zadania.

delete

Usuwa pracę domową.

get

Zwraca zadanie z kursu.

getAddOnContext

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

list

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

modifyAssignees

Modyfikuje tryb przypisania i opcje zajęć.

patch

Zaktualizuje co najmniej 1 pole projektu zajęć.