REST Resource: courses.courseWork

Zasób: CourseWork

Zadanie utworzone przez nauczyciela dla uczniów biorących udział w zajęciach.

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)
  },

  // 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.
}
Pola
courseId

string

Identyfikator zajęć.

Tylko do odczytu.

id

string

Przypisany przez Classroom identyfikator tego zadania w ramach zajęć, unikalny dla danych zajęć.

Tylko do odczytu.

title

string

Tytuł tego kursu. Tytuł musi być prawidłowym ciągiem znaków UTF-8 o długości od 1 do 3000 znaków.

description

string

Opcjonalny opis tego zadania w ramach kursu. Jeśli jest ustawiony, opis musi być prawidłowym ciągiem znaków UTF-8 o długości nieprzekraczającej 30 000 znaków.

materials[]

object (Material)

Dodatkowe materiały.

CourseWork może zawierać maksymalnie 20 elementów.

state

enum (CourseWorkState)

Stan tego zadania na kursie. Jeśli nie określono inaczej, stan domyślny to DRAFT.

creationTime

string (Timestamp format)

Sygnatura czasowa utworzenia tego zadania w ramach zajęć.

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 zadaniu w 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)

Opcjonalna data (czasu UTC) nadsyłania zgłoszeń na potrzeby tego kursu. Tę wartość należy określić, jeśli określono dueTime.

dueTime

object (TimeOfDay)

Opcjonalny termin (w strefie czasowej UTC) na przesyłanie zadań w ramach tego kursu. Tę wartość należy określić, jeśli określono dueDate.

scheduledTime

string (Timestamp format)

Opcjonalna sygnatura czasowa zaplanowania publikacji tego 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 z kursu. Jeśli zero lub wartość nie jest określona, projekt jest uznawany za bez oceny. Wartość musi być nieujemną liczbą całkowitą.

workType

enum (CourseWorkType)

Typ tego zadania w kursie.

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

associatedWithDeveloper

boolean

Określa, czy ten element zadania jest powiązany z projektem w Konsoli programisty, z którego pochodzi prośba.

Więcej informacji: courseWork.create.

Tylko do odczytu.

assigneeMode

enum (AssigneeMode)

Tryb przypisanego ucznia. Jeśli wartość nie jest określona, wartością domyślną jest ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

Identyfikatory uczniów z dostępem do materiałów dydaktycznych. To pole jest ustawiane tylko wtedy, gdy assigneeMode ma wartość INDIVIDUAL_STUDENTS. Jeśli assigneeMode to INDIVIDUAL_STUDENTS, tylko uczniowie wskazani w tym polu otrzymują zadanie.

submissionModificationMode

enum (SubmissionModificationMode)

Ustawienie określające, kiedy uczniowie mogą modyfikować przesłane zadania. Jeśli wartość nie jest określona, wartością domyślną jest MODIFIABLE_UNTIL_TURNED_IN.

creatorUserId

string

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

Tylko do odczytu.

topicId

string

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

gradeCategory

object (GradeCategory)

Kategoria, do której odnosi się ocena tego zadania. Prezentuj tylko wtedy, gdy dla zadania została wybrana kategoria. Może być brana pod uwagę przy obliczaniu oceny ogólnej.

Tylko do odczytu.

Pole sumy details. Dodatkowe informacje specyficzne dla konkretnego typu zadania na kursie. 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 należy określić podczas tworzenia zadania w polu workType o wartości MULTIPLE_CHOICE_QUESTION i nie można go ustawiać w inny sposób.

CourseWorkState

Możliwe stany zadania.

Wartości w polu enum
COURSE_WORK_STATE_UNSPECIFIED Nie określono stanu. Ta wartość nigdy nie jest zwracana.
PUBLISHED Stan opublikowanego zadania. Jest to stan domyślny.
DRAFT Stan zadania, które nie zostało jeszcze opublikowane. Zadania w tym stanie są widoczne tylko dla nauczycieli zajęć i administratorów domeny.
DELETED Stan opublikowanego zadania, które zostało usunięte. Zadania w tym stanie są widoczne tylko dla nauczycieli zajęć i administratorów domeny. Praca w tym stanie jest po pewnym czasie usuwana.

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 Zadania można modyfikować przed ich oddaniem.
MODIFIABLE Przesłane treści można modyfikować 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. Pole jest wypełniane tylko w przypadku nauczycieli i administratorów zajęć.

MultipleChoiceQuestion

Dodatkowe informacje na temat pytań jednokrotnego wyboru.

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

string

Możliwe opcje.

Metody

create

Tworzy zadanie domowe.

delete

Usuwa zadanie.

get

Zwraca zadanie na kurs.

getAddOnContext

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

list

Zwraca listę zadań na zajęciach, które osoba zgłaszająca może wyświetlić.

modifyAssignees

Modyfikuje tryb przypisywania osób i opcje zadania.

patch

Aktualizuje jedno lub więcej pól zadania.