REST Resource: courses.courseWork

Ресурс: CourseWork

Задания, созданные преподавателем для учащихся курса.

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
}
Поля
courseId

string

Идентификатор курса.

Только для чтения.
id

string

Идентификатор задания, назначенный Классом. Уникален в пределах курса.

Только для чтения.
title

string

Название работы на курсе. Название должно быть действительной строкой UTF-8, содержащей от 1 до 3000 символов.
description

string

Необязательное описание задания. Если описание задано, оно должно быть действительной строкой UTF-8,содержащей не более 30 000 символов.
materials[]

object (Material)

Дополнительные материалы.

В CourseWork должно быть не более 20 материалов.
state

enum (CourseWorkState)

Статус этого задания. Если оно не задано, используется значение по умолчанию – DRAFT.
creationTime

string (Timestamp format)

Временная метка создания задания.

Только для чтения.

Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Временная метка последнего изменения в этом задании.

Только для чтения.

Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30".
dueDate

object (Date)

Необязательная дата (в формате UTC), до которой нужно сдать работу. Это свойство необходимо указать, если задано свойство dueTime.
dueTime

object (TimeOfDay)

Необязательное время дня (по UTC), до которого нужно сдать работу. Это свойство необходимо указать, если задано свойство dueDate.
scheduledTime

string (Timestamp format)

Необязательная временная метка, указывающая, когда запланирована публикация этого задания.

Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30".
maxPoints

number

Максимальная оценка за эту курсовую работу. Если указан ноль или значение не задано, задание считается неоцениваемым. Значение должно быть неотрицательным целым числом.
workType

enum (CourseWorkType)

Тип этой курсовой работы.

Тип задается при создании задания и не может быть изменен.
associatedWithDeveloper

boolean

Связано ли это задание с проектом Developer Console, который отправляет запрос.

Подробную информацию можно найти на сайте courseWork.create.

Только для чтения.
assigneeMode

enum (AssigneeMode)

Режим исполнителя для задания. Если оно не задано, используется значение по умолчанию – ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

Идентификаторы учащихся, у которых есть доступ к заданию. Это поле задается, только если для assigneeMode указано значение INDIVIDUAL_STUDENTS. Если для параметра assigneeMode задано значение INDIVIDUAL_STUDENTS, то задание назначается только учащимся, указанным в этом поле.
submissionModificationMode

enum (SubmissionModificationMode)

Настройка, определяющая, когда учащимся разрешено изменять отправленные работы. Если оно не задано, используется значение по умолчанию – MODIFIABLE_UNTIL_TURNED_IN.
creatorUserId

string

Идентификатор пользователя, создавшего задание.

Только для чтения.
topicId

string

Идентификатор темы, с которой связано это задание. Должно совпадать с существующей темой в курсе.
gradeCategory

object (GradeCategory)

Категория, к которой относится оценка за это задание. Присутствует, только если для задания выбрана категория. Может использоваться при расчете общей оценки.

Только для чтения.
previewVersion

enum (PreviewVersion)

Только для вывода. Предварительная версия API, используемая для получения этого ресурса.
learningGoals[]

object (LearningGoal)

Необязательное поле.

Ссылки на учебные цели, связанные с этим заданием. В CourseWork может быть не более 10 учебных целей. Это поле заполняется, только если задано соответствующее значение previewVersion.
Дополнительные сведения, относящиеся к определенному типу задания. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей:
assignment

object (Assignment)

Сведения о назначении. Заполняется, только если workType – ASSIGNMENT.

Только для чтения.
multipleChoiceQuestion

object (MultipleChoiceQuestion)

Сведения о вопросе с несколькими вариантами ответа. При операциях чтения это поле заполняется, только если workType имеет значение MULTIPLE_CHOICE_QUESTION. Для операций записи это поле должно быть указано при создании задания с workType MULTIPLE_CHOICE_QUESTION, и его нельзя задавать в других случаях.
Конец взаимоисключающих полей.
gradingPeriodId

string

Идентификатор академического периода, связанного с заданием.

  • Если при создании идентификатор академического периода не указан, он будет задан на основе dueDate (или scheduledTime, если dueDate не задан).
  • Чтобы указать, что задание не связано ни с одним академическим периодом, оставьте это поле пустым ("").
  • Если указан, должен совпадать с идентификатором существующего академического периода в курсе.

CourseWorkState

Возможные статусы курсовой работы.

Перечисления
COURSE_WORK_STATE_UNSPECIFIED Штат не указан. Это значение никогда не возвращается.
PUBLISHED Статус опубликованной работы. Это состояние по умолчанию.
DRAFT Статус работы, которая ещё не опубликована. Работы в этом статусе видны только преподавателям курса и администраторам домена.
DELETED Статус работы, которая была опубликована, но затем удалена. Работы в этом статусе видны только преподавателям курса и администраторам домена. Через некоторое время работа в этом состоянии удаляется.

SubmissionModificationMode

Возможные режимы изменения для работ учащихся.

Перечисления
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Не указан режим изменения. Это значение никогда не возвращается.
MODIFIABLE_UNTIL_TURNED_IN До отправки работы можно изменить.
MODIFIABLE Изменять отправленные данные можно в любое время.

Assignment

Дополнительные сведения о заданиях.

JSON-представление 
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
Поля
studentWorkFolder

object (DriveFolder)

Папка на Диске, в которую помещаются прикрепленные файлы из работ учащихся. Это поле заполняется только для преподавателей и администраторов курса.

MultipleChoiceQuestion

Дополнительные сведения о вопросах с несколькими вариантами ответа.

JSON-представление 
{
  "choices": [
    string
  ]
}
Поля
choices[]

string

Возможные варианты.

Методы

create

 создавать задания;

delete

 Удаляет задание.

get

 Возвращает задание.

getAddOnContext

 Позволяет получить метаданные дополнений Google Класса в контексте определенной записи.

list

 Возвращает список заданий, которые разрешено просматривать отправителю запроса.

modifyAssignees

 Изменяет режим исполнителя и параметры задания.

patch

 Обновляет одно или несколько полей задания.