REST Resource: courses.courseWork.studentSubmissions

Ресурс: StudentSubmission

Представление студенческой курсовой работы.

Элементы StudentSubmission генерируются при создании элемента CourseWork .

Студенческие работы, к которым никогда не обращались (т. е. имеющие state = NEW), могут не иметь времени создания или времени обновления.

JSON-представление 
{
  "courseId": string,
  "courseWorkId": string,
  "id": string,
  "userId": string,
  "creationTime": string,
  "updateTime": string,
  "state": enum (SubmissionState),
  "late": boolean,
  "draftGrade": number,
  "assignedGrade": number,
  "rubricId": string,
  "draftRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "assignedRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  // Union field content can be only one of the following:
  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
  // End of list of possible types for union field content.
}
Поля
courseId

string

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

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

courseWorkId

string

Идентификатор курсовой работы, которой это соответствует.

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

id

string

Идентификатор, присвоенный студенту в классе. Он уникален среди всех работ, представленных в рамках соответствующего курса.

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

userId

string

Идентификатор студента, которому принадлежит эта работа.

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

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" .

state

enum ( SubmissionState )

Состояние данного представления.

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

late

boolean

Является ли данное представление запоздалым.

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

draftGrade

number

Необязательная отложенная оценка. Если не установлено, оценка не выставлена. Это значение должно быть неотрицательным. Десятичные (то есть нецелые) значения допускаются, но округляются до двух знаков после запятой.

Видно и изменять эту информацию могут только преподаватели курса.

assignedGrade

number

Необязательная оценка. Если не задано, оценка не установлена. Это значение должно быть неотрицательным. Десятичные (то есть нецелые) значения допускаются, но округляются до двух знаков после запятой.

Изменять это положение могут только преподаватели курса.

rubricId

string

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

Этот идентификатор пуст, если критерии оценки отсутствуют. Он отражает текущую активную критерии оценки; он изменяется, если учитель удаляет и заново создает критерии оценки.

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

draftRubricGrades

map (key: string, value: object ( RubricGrade ))

Ожидаемые оценки по рубрикам на основе критериев рубрики.

Эта карта пуста, если к данной курсовой работе не привязана рубрика или если рубрика привязана, но оценки по каким-либо критериям не выставлены. Записи заполняются только для выставленных оценок. Ключ: идентификатор критерия рубрики.

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

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

assignedRubricGrades

map (key: string, value: object ( RubricGrade ))

Оценки по рубрикам присваиваются на основе критериев рубрики.

Эта карта пуста, если к курсовой работе не привязана рубрика или она привязана, но оценки по критериям не выставлены. Записи заполняются только для выставленных оценок. Ключ: идентификатор критерия рубрики.

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

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

courseWorkType

enum ( CourseWorkType )

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

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

associatedWithDeveloper

boolean

Связана ли данная студенческая заявка с проектом Developer Console, сделавшим запрос.

Более подробную информацию см. courseWork.create .

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

submissionHistory[]

object ( SubmissionHistory )

История отправки (включая историю штата и оценок).

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

previewVersion

enum ( PreviewVersion )

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

content объединенного поля. Содержимое отправляемой работы. Конкретный тип зависит от значения course_work_type . content может быть только одним из следующих:
assignmentSubmission

object ( AssignmentSubmission )

Содержимое отправленной работы, если courseWorkType — ASSIGNMENT.

Студенты могут изменять этот контент с помощью studentSubmissions.modifyAttachments .

shortAnswerSubmission

object ( ShortAnswerSubmission )

Содержимое отправления, если courseWorkType — SHORT_ANSWER_QUESTION.

multipleChoiceSubmission

object ( MultipleChoiceSubmission )

Содержимое отправления, когда courseWorkType — MULTIPLE_CHOICE_QUESTION.

RubricGrade

Оценка по критериям, установленным для студенческой работы. Для каждого критерия оценки допускается не более одной работы.

JSON-представление 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
Поля
criterionId

string

Необязательно. Идентификатор критерия.

levelId

string

Необязательно. Необязательный идентификатор выбранного уровня. Если пусто, уровень не выбран.

points

number

Необязательный. Баллы за этот критерий начисляются необязательно, обычно в зависимости от уровня. Уровни могут начисляться или не начисляться баллами. Если не установлено, баллы за этот критерий не начислялись.

ЗаданиеПодача

Студенческая работа по заданию.

JSON-представление 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
Поля
attachments[]

object ( Attachment )

Вложения, добавленные учащимся. Файлы на Диске, соответствующие материалам с режимом общего доступа STUDENT_COPY, могут быть ещё не созданы, если учащийся не открыл задание в Classroom.

Некоторые метаданные вложения заполняются только при наличии у запрашивающего пользователя разрешения на доступ к ним. Поля «Идентификатор» и «Альтернативная ссылка» доступны всегда, но другие (например, «Заголовок») могут быть недоступны.

Вложение

Приложение добавлено к студенческой работе.

При создании вложений настройка поля form не поддерживается.

JSON-представление 
{

  // Union field attachment can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field attachment.
}
Поля
attachment поля Union. Данные вложения. attachment может быть только одним из следующих:
driveFile

object ( DriveFile )

Вложение файла Google Диска.

youTubeVideo

object ( YouTubeVideo )

Видео-вложение с YouTube.

form

object ( Form )

Вложение Google Forms.

ShortAnswerSubmission

Студенческая работа на вопрос с кратким ответом.

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

string

Ответ студента на вопрос, требующий краткого ответа.

MultipleChoiceSubmission

Студенческая работа по вопросу с несколькими вариантами ответов.

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

string

Выбор студента.

История отправки

История отправки. В настоящее время включает историю штата и историю оценок.

JSON-представление 
{

  // Union field type can be only one of the following:
  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
  // End of list of possible types for union field type.
}
Поля
type поля объединения. Тип SubmissionHistory может быть одним из StateHistory или GradeHistory. type может быть только одним из следующих:
stateHistory

object ( StateHistory )

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

gradeHistory

object ( GradeHistory )

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

История государства

История каждого штата, в котором находилась данная заявка.

JSON-представление 
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
Поля
state

enum ( State )

Этап конвейера рабочего процесса.

stateTimestamp

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" .

actorUserId

string

Учитель или ученик, внесший изменение.

Состояние

Возможные состояния, в которых может находиться заявка.

Перечисления
STATE_UNSPECIFIED Штат не указан. Этот вариант не подлежит возврату.
CREATED Представление создано.
TURNED_IN Студент сдал назначенный документ, который может быть шаблоном, а может и не быть.
RETURNED Преподаватель вернул студенту назначенный документ.
RECLAIMED_BY_STUDENT Студент сдал назначенный документ, а затем решил «отменить» отправку задания, снова получив контроль над ним как владелец.
STUDENT_EDITED_AFTER_TURN_IN Студент отредактировал свою работу после сдачи. В настоящее время используется только в разделе «Вопросы», когда студент редактирует свой ответ.

История оценок

История каждой оценки в данной работе.

JSON-представление 
{
  "pointsEarned": number,
  "maxPoints": number,
  "gradeTimestamp": string,
  "actorUserId": string,
  "gradeChangeType": enum (GradeChangeType)
}
Поля
pointsEarned

number

Числитель оценки на данный момент в истории оценок отправки.

maxPoints

number

Знаменатель оценки на данный момент в истории оценок отправки.

gradeTimestamp

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" .

actorUserId

string

Учитель, который изменил оценку.

gradeChangeType

enum ( GradeChangeType )

Тип изменения оценки на данный момент в истории оценок отправки.

GradeChangeType

Возможные типы изменения оценок.

Перечисления
UNKNOWN_GRADE_CHANGE_TYPE Тип изменения оценки не указан. Этот вариант никогда не следует возвращать.
DRAFT_GRADE_POINTS_EARNED_CHANGE Изменение числителя оценки проекта.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Изменение числителя присвоенной оценки.
MAX_POINTS_CHANGE Изменение знаменателя оценки.

Методы

get

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

list

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

modifyAttachments

 Изменяет вложения к студенческим работам.

patch

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

reclaim

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

return

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

turnIn

 Сдает студенческую работу.