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 не указан параметр dueTime, то в срок выполнения для параметра dueTime будет установлено значение 23:59.
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

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