REST Resource: courses.courseWork.studentSubmissions

Ресурс: StudentSubmission

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

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

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

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)

Время создания данного представления. Это значение можно отключить, если учащийся не получил доступа к этому элементу.

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

Временная метка в формате 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" .

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.

РубрикаОценка

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

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

string

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

levelId

string

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

points

number

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

НазначениеОтправка

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

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

object ( Attachment )

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

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

Вложение

К заданиям учащихся добавлено приложение.

При создании вложений настройка поля 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 )

Вложение видео с Ютуба.

form

object ( Form )

Приложение Google Forms.

КороткийОтветОтправка

Учащиеся работают над кратким ответом на вопрос.

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

string

Ответ ученика на вопрос с кратким ответом.

Множественный выборОтправка

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

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)

Когда представление вошло в это состояние.

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

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)

Когда была изменена оценка доклада.

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

actorUserId

string

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

gradeChangeType

enum ( GradeChangeType )

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

ОценкаChangeType

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

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

 Сдает студенческую заявку.