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 tej części 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 muszą zawierać nie więcej niż 20 elementów.
state

enum (CourseWorkState)

Stan pracy nad tym kursem. Jeśli nie podasz żadnej wartości, stan domyślny to DRAFT.
creationTime

string (Timestamp format)

Sygnatura czasowa utworzenia tego zadania.

Tylko do odczytu.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne 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 projekcie.

Tylko do odczytu.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne 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, do której należy przesłać pracę związaną z tym kursem. Jeśli podano parametr dueTime, musisz podać ten parametr.
dueTime

object (TimeOfDay)

Opcjonalna pora dnia w strefie czasowej UTC, do której należy przesłać projekty z tego kursu. Jeśli podano parametr dueDate, musisz podać ten parametr.
scheduledTime

string (Timestamp format)

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

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne 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ść jest równa 0 lub nie jest określona, projekt jest uważany za nieoceniony. Musi to być nieujemna liczba całkowita.
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 przypisywane 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 edukacyjne.

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 projektu. 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 szczegóły 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.

  • Podczas tworzenia, 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 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 pracy, która nie została jeszcze opublikowana. W tym stanie zadania są widoczne tylko dla nauczycieli i administratorów domeny.
DELETED Stan pracy, która została opublikowana, ale została teraz usunięta. W tym stanie zadania są widoczne 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 z przesłanych przez uczniów projektó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

 tworzenia zadań.

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.