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),
  "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 )

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

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

state

enum ( CourseWorkState )

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

creationTime

string ( Timestamp format)

Указана временная метка, когда была создана эта курсовая работа.

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

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "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 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "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 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "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

Указывается, связана ли данная работа по курсу с проектом в консоли разработчика, для которого был сделан запрос.

Более подробную информацию см. в 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 )

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

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

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

Режим изменения формы отправки

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

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

Назначение

Дополнительная информация о заданиях.

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

object ( DriveFolder )

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

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

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

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

string

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

Методы

create

 Создаёт учебные задания.

delete

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

get

 Возвращает выполненные курсовые работы.

getAddOnContext

 Получает метаданные для дополнений Classroom в контексте конкретной публикации.

list

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

modifyAssignees

 Изменяет режим работы и параметры выполнения учебного задания.

patch

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