REST Resource: courses.courseWork

Zasób: CourseWork

Zadania 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),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

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

string

Identyfikator szkolenia.

Tylko do odczytu.
id

string

Identyfikator zadania przypisany przez Classroom, unikalny w ramach zajęć.

Tylko do odczytu.
title

string

Tytuł tego 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.

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

enum (CourseWorkState)

Stan tej pracy domowej. Jeśli nie określisz tu żadnej wartości, zostanie użyty stan domyślny DRAFT.
creationTime

string (Timestamp format)

Sygnatura czasowa utworzenia tego zadania.

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

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 UTC), do której należy przesłać projekty w ramach tego kursu. Ten parametr musi być określony, jeśli podano parametr dueTime.
dueTime

object (TimeOfDay)

Opcjonalna pora dnia w UTC, w której należy przesłać prace na ten kurs. Ten parametr musi być określony, jeśli podano parametr dueDate.
scheduledTime

string (Timestamp format)

Opcjonalna sygnatura czasowa, kiedy 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ść jest równa zero lub nie jest określona, projekt jest uznawany za nieoceniony. Musi to być nieujemna liczba całkowita.
workType

enum (CourseWorkType)

Typ zadania.

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

boolean

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

Więcej informacji znajdziesz w sekcji courseWork.create.

Tylko do odczytu.
assigneeMode

enum (AssigneeMode)

Tryb przypisania materiałów dydaktycznych. Jeśli nie podasz żadnej opcji, domyślną wartością będzie 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 wartość assigneeMode to INDIVIDUAL_STUDENTS, materiały dydaktyczne zostaną przypisane tylko uczniom określonym w tym polu.
submissionModificationMode

enum (SubmissionModificationMode)

Ustawienie określające, kiedy uczniowie mogą modyfikować przesłane prace. Jeśli nie podasz żadnej opcji, domyślną wartością będzie 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ą te materiały dydaktyczne. Musi pasować do istniejącego tematu w kursie.
gradeCategory

object (GradeCategory)

Kategoria, do której zalicza się ocena za to zadanie. Wyświetlane tylko wtedy, gdy do zadania domowego wybrano kategorię. Może być używany do obliczania oceny ogólnej.

Tylko do odczytu.
previewVersion

enum (PreviewVersion)

Tylko dane wyjściowe. Wersja interfejsu API w wersji podglądowej użyta do pobrania tego zasobu.
learningGoals[]

object (LearningGoal)

Opcjonalnie.

odniesienia do celów edukacyjnych powiązanych z tym zadaniem. To pole jest wypełniane tylko wtedy, gdy ustawiona jest odpowiednia wartość PreviewVersion. Projekt może mieć maksymalnie 10 celów edukacyjnych.
Pole zbiorcze details. Dodatkowe szczegóły dotyczące 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 wartość workType to MULTIPLE_CHOICE_QUESTION. W przypadku operacji zapisu to pole musi być określone podczas tworzenia pracy domowej z wartością workType równą MULTIPLE_CHOICE_QUESTION. W innych przypadkach nie może być ustawione.
gradingPeriodId

string

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

  • Jeśli podczas tworzenia nie zostanie podany identyfikator okresu oceniania, zostanie on ustawiony na podstawie wartości dueDate (lub scheduledTime, jeśli nie ustawiono wartości dueDate).
  • Aby wskazać brak powiązania z jakimkolwiek okresem oceniania, ustaw to pole na pusty ciąg znaków („”).
  • Jeśli zostanie określony, musi pasować do identyfikatora istniejącego okresu oceniania w kursie.

CourseWorkState

Możliwe stany pracy na zajęciach.

Wartości w polu enum
COURSE_WORK_STATE_UNSPECIFIED Nie określono stanu. Nigdy nie jest zwracany.
PUBLISHED Stan opublikowanych treści. Jest to stan domyślny.
DRAFT Stan treści, które nie zostały jeszcze opublikowane. Prace w tym stanie są widoczne tylko dla nauczycieli prowadzących kurs i administratorów domeny.
DELETED Stan prac, które zostały opublikowane, ale są teraz usunięte. Prace w tym stanie są widoczne tylko dla nauczycieli prowadzących kurs i administratorów domeny. Zadania w tym stanie są po pewnym czasie usuwane.

SubmissionModificationMode

Możliwe tryby modyfikacji przesłanych prac uczniów.

Wartości w polu enum
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Nie określono trybu modyfikacji. Nie jest on nigdy zwracany.
MODIFIABLE_UNTIL_TURNED_IN Przed przesłaniem można wprowadzać zmiany w przesłanych materiałach.
MODIFIABLE Przesłane materiały można w każdej chwili zmodyfikować.

Projekt

Dodatkowe szczegóły dotyczące projektów.

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

object (DriveFolder)

Folder na Dysku, w którym umieszczane są załączniki z przesłanych przez uczniów projektów. Ta wartość jest podawana tylko w przypadku nauczycieli i administratorów kursu.

MultipleChoiceQuestion

Dodatkowe informacje o pytaniach jednokrotnego wyboru.

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

string

Możliwe opcje.

Metody

create

 tworzyć zadania;

delete

 Usuwa projekt.

get

 Zwraca zadanie.

getAddOnContext

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

list

 Zwraca listę prac domowych, które osoba wysyłająca prośbę może wyświetlić.

modifyAssignees

 Zmienia tryb przypisania i opcje materiałów dydaktycznych.

patch

 Aktualizuje co najmniej jedno pole pracy domowej.