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

string

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

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

id

string

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

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

title

string

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

description

string

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

materials[]

object ( Material )

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

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

state

enum ( CourseWorkState )

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

creation Time

string ( Timestamp format)

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

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

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

update Time

string ( Timestamp format)

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

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

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

due Date

object ( Date )

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

due Time

object ( TimeOfDay )

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

scheduled Time

string ( Timestamp format)

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

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

max Points

number

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

work Type

enum ( CourseWorkType )

Вид данной курсовой работы.

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

associated With Developer

boolean

Связан ли этот рабочий элемент курса с проектом Developer Console, отправляющим запрос.

Дополнительную информацию см. в курсе courseWork.create .

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

assignee Mode

enum ( AssigneeMode )

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

individual Students Options

object ( IndividualStudentsOptions )

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

submission Modification Mode

enum ( SubmissionModificationMode )

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

creator User Id

string

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

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

topic Id

string

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

grade Category

object ( GradeCategory )

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

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

preview Version

enum ( PreviewVersion )

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

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

object ( Assignment )

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

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

multiple Choice Question

object ( MultipleChoiceQuestion )

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

grading Period Id

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)
  }
}
Поля
student Work Folder

object ( DriveFolder )

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

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

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

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

string

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

Методы

create

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

delete

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

get

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

get Add On Context

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

list

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

modify Assignees

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

patch

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