- Ресурс: StudentSubmission
- РубрикаОценка
- НазначениеОтправка
- Вложение
- КороткийОтветОтправка
- Множественный выборОтправка
- История отправки
- ГосударственнаяИстория
- Состояние
- История оценок
- ОценкаChangeType
- Методы
Ресурс: StudentSubmission
Представление студента на курсовую работу.
Элементы StudentSubmission
генерируются при создании элемента CourseWork
.
Студенческие материалы, к которым никогда не обращались (т. е. со state
= НОВЫЙ), могут не иметь времени создания или времени обновления.
JSON-представление |
---|
{ "courseId": string, "courseWorkId": string, "id": string, "userId": string, "creationTime": string, "updateTime": string, "state": enum ( |
Поля | |
---|---|
courseId | Идентификатор курса. Только для чтения. |
courseWorkId | Идентификатор курсовой работы, которому она соответствует. Только для чтения. |
id | Идентификатор, присвоенный классом для подачи учащегося. Это уникальное явление среди представленных материалов для соответствующей курсовой работы. Только для чтения. |
userId | Идентификатор учащегося, которому принадлежит эта отправка. Только для чтения. |
creationTime | Время создания данного представления. Это значение можно отключить, если учащийся не получил доступа к этому элементу. Только для чтения. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
updateTime | Время последнего обновления этого представления. Это значение можно отключить, если учащийся не получил доступа к этому элементу. Только для чтения. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
state | Состояние этого представления. Только для чтения. |
late | Является ли это представление опоздавшим. Только для чтения. |
draftGrade | Необязательная ожидающая оценка. Если параметр не установлен, оценка не была установлена. Это значение должно быть неотрицательным. Десятичные (то есть нецелые) значения допускаются, но округляются до двух знаков после запятой. Это видно и может быть изменено только преподавателями курса. |
assignedGrade | Необязательная оценка. Если параметр не установлен, оценка не была установлена. Это значение должно быть неотрицательным. Десятичные (то есть нецелые) значения допускаются, но округляются до двух знаков после запятой. Это могут изменить только преподаватели курса. |
rubricId | Только вывод. Идентификатор рубрики, которая в настоящее время прикреплена к этой курсовой работе и используется для оценки работы этого студента. Этот идентификатор пуст, если рубрика отсутствует. Этот идентификатор отражает активную в данный момент рубрику; оно изменится, если учителя удалят и заново создадут рубрику. Только для чтения. |
draftRubricGrades | Ожидаемые оценки рубрики на основе критериев рубрики. Эта карта пуста, если к данной курсовой работе не присвоена рубрика или если рубрика прикреплена, но ни по одному из критериев не выставлены оценки. Записи заполняются только для установленных оценок. Ключ: идентификатор критерия рубрики. Только для чтения. Объект, содержащий список пар |
assignedRubricGrades | Оценки по рубрикам присваиваются на основе критериев рубрики. Эта карта пуста, если к данной курсовой работе не присвоена рубрика, или если рубрика прикреплена, но ни по одному из критериев не выставлены оценки. Записи заполняются только для установленных оценок. Ключ: идентификатор критерия рубрики. Только для чтения. Объект, содержащий список пар |
alternateLink | Абсолютная ссылка на отправку в веб-интерфейсе Класса. Только для чтения. |
courseWorkType | Тип курсовой работы, для которой предназначена данная заявка. Только для чтения. |
associatedWithDeveloper | Связана ли эта заявка учащегося с проектом Developer Console, отправляющим запрос. Дополнительную информацию см. в курсе Только для чтения. |
submissionHistory[] | История подачи (включает историю состояний и оценок). Только для чтения. |
previewVersion | Только вывод. Предварительная версия API. Это необходимо настроить, чтобы получить доступ к новым возможностям API, доступным разработчикам в программе предварительной версии. |
content поля объединения. Содержание подачи. Конкретный тип зависит от значения course_work_type . content может быть только одним из следующих: | |
assignmentSubmission | Содержимое отправки, если для параметра CourseWorkType установлено значение ASSIGNMENT. Студенты могут изменять этот контент с помощью |
shortAnswerSubmission | Содержимое отправки, если для параметра CourseWorkType установлено значение SHORT_ANSWER_QUESTION. |
multipleChoiceSubmission | Содержимое отправки, если для параметра CourseWorkType установлено значение MULTIPLE_CHOICE_QUESTION. |
РубрикаОценка
Оценка по критериям, установленная для работ учащихся. Для каждого критерия рубрики может быть не более одной записи.
JSON-представление |
---|
{ "criterionId": string, "levelId": string, "points": number } |
Поля | |
---|---|
criterionId | Необязательный. Идентификатор критерия. |
levelId | Необязательный. Необязательный идентификатор выбранного уровня. Если пусто, уровень не выбран. |
points | Необязательный. Дополнительные баллы, начисляемые по этому критерию, обычно в зависимости от уровня. Уровни могут иметь или не иметь очки. Если параметр не установлен, для этого критерия не было установлено никаких баллов. |
НазначениеОтправка
Ученическая работа по заданию.
JSON-представление |
---|
{
"attachments": [
{
object ( |
Поля | |
---|---|
attachments[] | Вложения добавлены учащимся. Файлы на Диске, соответствующие материалам с режимом общего доступа STUDENT_COPY, могут еще не существовать, если учащийся не получил доступ к заданию в Классе. Некоторые метаданные вложений заполняются только в том случае, если запрашивающий пользователь имеет разрешение на доступ к ним. Поля «Идентификатор» и «Альтернативная ссылка» всегда доступны, но другие (например, заголовок) могут быть недоступны. |
Вложение
К заданиям учащихся добавлено приложение.
При создании вложений настройка поля form
не поддерживается.
JSON-представление |
---|
{ // Union field |
Поля | |
---|---|
attachment поля Union. Данные о прикреплении. attachment может быть только одним из следующих: | |
driveFile | Вложенный файл Google Диска. |
youTubeVideo | Вложение видео с Ютуба. |
link | Вложение ссылки. |
form | Приложение Google Forms. |
КороткийОтветОтправка
Учащиеся работают над кратким ответом на вопрос.
JSON-представление |
---|
{ "answer": string } |
Поля | |
---|---|
answer | Ответ ученика на вопрос с кратким ответом. |
Множественный выборОтправка
Работа учащихся над вопросом с несколькими вариантами ответов.
JSON-представление |
---|
{ "answer": string } |
Поля | |
---|---|
answer | Выбор ученика. |
История отправки
История подачи. В настоящее время сюда входят истории штатов и классов.
JSON-представление |
---|
{ // Union field |
Поля | |
---|---|
type поля объединения. Тип SubmissionHistory может быть одним из StateHistory, GradeHistory. type может быть только одним из следующих: | |
stateHistory | Информация об истории состояния подачи, если она присутствует. |
gradeHistory | Информация об истории оценок отправленного материала, если таковая имеется. |
ГосударственнаяИстория
История каждого штата, в котором побывала эта заявка.
JSON-представление |
---|
{
"state": enum ( |
Поля | |
---|---|
state | Этап конвейера рабочего процесса. |
stateTimestamp | Когда представление вошло в это состояние. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
actorUserId | Учитель или ученик, внесший изменение. |
Состояние
Возможные состояния отправки.
Перечисления | |
---|---|
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 ( |
Поля | |
---|---|
pointsEarned | Числитель оценки на данный момент в истории оценок отправки. |
maxPoints | Знаменатель оценки на данный момент в истории оценок отправки. |
gradeTimestamp | Когда была изменена оценка доклада. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
actorUserId | Учитель, который изменил оценку. |
gradeChangeType | Тип оценки изменяется в данный момент в истории оценок отправки. |
ОценкаChangeType
Возможные типы изменения оценок.
Перечисления | |
---|---|
UNKNOWN_GRADE_CHANGE_TYPE | Тип изменения оценки не указан. Это никогда не должно быть возвращено. |
DRAFT_GRADE_POINTS_EARNED_CHANGE | Изменение числителя черновой оценки. |
ASSIGNED_GRADE_POINTS_EARNED_CHANGE | Изменение числителя присвоенной оценки. |
MAX_POINTS_CHANGE | Изменение знаменателя оценки. |
Методы | |
---|---|
| Возвращает заявку студента. |
| Возвращает список материалов учащихся, которые запрашивающему разрешено просматривать, с учетом областей OAuth запроса. |
| Изменяет вложения, отправленные студентами. |
| Обновляет одно или несколько полей заявки учащегося. |
| Восстанавливает заявку учащегося от имени учащегося, которому она принадлежит. |
| Возвращает заявку студента. |
| Сдает студенческую заявку. |