REST Resource: courses.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),

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

string

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

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

id

string

Идентификатор данной курсовой работы, присвоенный классом, уникальный для каждого курса.

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

title

string

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

description

string

Дополнительное описание данной курсовой работы. Если этот параметр установлен, описание должно представлять собой действительную строку UTF-8, содержащую не более 30 000 символов.

materials[]

object ( Material )

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

Курсовая работа должна содержать не более 20 материальных позиций.

state

enum ( CourseWorkState )

Статус курсовой работы. Если не указано, состояние по умолчанию — DRAFT .

creationTime

string ( Timestamp format)

Временная метка создания этой курсовой работы.

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

updateTime

string ( Timestamp format)

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

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

dueDate

object ( Date )

Необязательная дата в формате UTC, когда необходимо подать документы на эту курсовую работу. Это необходимо указать, если указан dueTime .

dueTime

object ( TimeOfDay )

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

scheduledTime

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

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, используемая для получения этого ресурса.

details поля объединения. Дополнительные сведения, специфичные для типа курсовой работы. details могут быть только одним из следующих:
assignment

object ( Assignment )

Детали задания. Это значение заполняется только в том случае, если workType имеет ASSIGNMENT .

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

multipleChoiceQuestion

object ( MultipleChoiceQuestion )

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

gradingPeriodId

string

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

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

Курсворкстате

Возможные состояния конечно работают.

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

Режим SubmissionModificationMode

Возможные режимы модификации студенческих работ.

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

Назначение

Дополнительные детали к заданиям.

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

object ( DriveFolder )

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

МножественныйВыборВопрос

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

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

string

Возможный выбор.

Методы

create

Создает курсовую работу.

delete

Удаляет курсовую работу.

get

Возвращает курсовую работу.

getAddOnContext

Получает метаданные для надстроек Класса в контексте определенного сообщения.

list

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

modifyAssignees

Изменяет режим исполнителя и параметры курсовой работы.

patch

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