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

string

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

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

course Work Id

string

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

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

id

string

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

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

user Id

string

Идентификатор учащегося, которому принадлежит эта отправка.

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

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

state

enum ( SubmissionState )

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

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

late

boolean

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

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

draft Grade

number

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

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

assigned Grade

number

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

Это могут изменить только преподаватели курса.

rubric Id

string

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

Этот идентификатор пуст, если рубрика отсутствует. Этот идентификатор отражает активную в данный момент рубрику; оно изменится, если учителя удалят и заново создадут рубрику.

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

draft Rubric Grades

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

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

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

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

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

assigned Rubric Grades

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

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

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

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

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

course Work Type

enum ( CourseWorkType )

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

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

associated With Developer

boolean

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

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

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

submission History[]

object ( SubmissionHistory )

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

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

preview Version

enum ( PreviewVersion )

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

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

object ( AssignmentSubmission )

Содержимое отправки, если для параметра CourseWorkType установлено значение ASSIGNMENT.

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

short Answer Submission

object ( ShortAnswerSubmission )

Содержимое отправки, если для параметра CourseWorkType установлено значение SHORT_ANSWER_QUESTION.

multiple Choice Submission

object ( MultipleChoiceSubmission )

Содержимое отправки, если для параметра CourseWorkType установлено значение MULTIPLE_CHOICE_QUESTION.

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

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

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

string

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

level Id

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 может быть только одним из следующих:
drive File

object ( DriveFile )

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

you Tube Video

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 может быть только одним из следующих:
state History

object ( StateHistory )

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

grade History

object ( GradeHistory )

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

ГосударственнаяИстория

История каждого штата, в котором побывала эта заявка.

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

enum ( State )

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

state Timestamp

string ( Timestamp format)

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

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

actor User Id

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)
}
Поля
points Earned

number

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

max Points

number

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

grade Timestamp

string ( Timestamp format)

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

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

actor User Id

string

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

grade Change Type

enum ( GradeChangeType )

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

ОценкаChangeType

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

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

Методы

get

 Возвращает заявку студента.

list

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

modify Attachments

 Изменяет вложения, отправленные студентами.

patch

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

reclaim

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

return

 Возвращает заявку студента.

turn In

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