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)

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

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

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

details о поле объединения. Дополнительные сведения, относящиеся к определённому типу курсовой работы. details может быть указано только одно из следующих:
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 Статус работы, которая была опубликована, но теперь удалена. Работа в этом состоянии видна только преподавателям курса и администраторам домена. Работа в этом состоянии удаляется через некоторое время.

Режим модификации отправки

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

Перечисления
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

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

list

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

modifyAssignees

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

patch

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