REST Resource: courses.courseWork

Zasób: CourseWork

Zadania 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)
  },
  "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 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.

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

enum (CourseWorkState)

Stan tego zadania. 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 używają 0, 3, 6 lub 9 cyfr ułamkowych. 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 używają 0, 3, 6 lub 9 cyfr ułamkowych. 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 strefie czasowej UTC), w której należy przesłać zadania z tego kursu. 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 używają 0, 3, 6 lub 9 cyfr ułamkowych. 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 zadania i nie można go zmienić.
associatedWithDeveloper

boolean

Określa, czy ten element kursu 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 projektu. 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 szkoleniowych. To pole jest ustawiane tylko wtedy, gdy assigneeMode ma wartość INDIVIDUAL_STUDENTS. Jeśli wartość assigneeMode to INDIVIDUAL_STUDENTS, projekt zostanie przypisany 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ł projekt.

Tylko do odczytu.
topicId

string

Identyfikator tematu, z którym powiązane są te zajęcia. Musi pasować do istniejącego tematu w kursie.
gradeCategory

object (GradeCategory)

Kategoria, do której zalicza się ocena za tę pracę. Wyświetla się tylko wtedy, gdy wybrano kategorię zadania. 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.
Pole unii 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 zadania 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 pracą domową.

  • 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 być zgodny z identyfikatorem istniejącego okresu oceniania w kursie.

CourseWorkState

Możliwe stany zadania.

Wartości w polu enum
COURSE_WORK_STATE_UNSPECIFIED Nie podano stanu. Nie jest on nigdy zwracany.
PUBLISHED Stan opublikowanych treści. Jest to stan domyślny.
DRAFT Stan prac, które nie zostały jeszcze opublikowane. Prace w tym stanie są widoczne tylko dla nauczycieli kursu i administratorów domeny.
DELETED Stan treści, które zostały opublikowane, ale są teraz usunięte. Prace w tym stanie są widoczne tylko dla nauczycieli kursu i administratorów domeny. Praca w tym stanie jest po pewnym czasie usuwana.

SubmissionModificationMode

Możliwe tryby modyfikacji przesłanych prac.

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 plikach.
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. To pole jest wypełniane tylko w przypadku nauczycieli i administratorów kursu.

MultipleChoiceQuestion

Dodatkowe informacje o pytaniach jednokrotnego wyboru.

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

string

Możliwe wybory.

Metody

create

 tworzenia zadań;

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 przypisywania i opcje zajęć.

patch

 Aktualizuje co najmniej jedno pole projektu.