Тип ресурса educationAssignment
Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Представляет задачу или единицу работы, назначенную учащемуся или участнику команды в классе в рамках его исследования.
Задания содержат раздаточные материалы и задачи, над которыми преподаватель хочет, чтобы учащийся работал. Каждое задание учащегося имеет связанную отправку , которая содержит любую работу, которую преподаватель попросил о сдаче. Создавать задания могут только преподаватели или владельцы команд. Преподаватель может добавить оценки и отзывы в отправку , поданную учащимся.
При создании назначения оно находится в состоянии черновика. Учащиеся не видят задание, и отправок не создаются. Состояние назначения можно изменить с помощью действия публикации . Вы не можете использовать запрос PATCH для изменения состояния назначения .
API-интерфейсы назначения предоставляются в пространстве имен класса.
Наследует от сущности.
Методы
| Метод | Возвращаемый тип | Описание |
|---|---|---|
| Создание ресурса задания | educationAssignmentResource | Создайте новый объект educationAssignmentResource , опубликовав его в коллекции ресурсов. |
| Получение задания | educationAssignment | Чтение свойств и связей объекта educationAssignment . |
| Обновление | educationAssignment | Обновление объекта educationAssignment . |
| удаление; | Нет | Удаление объекта educationAssignment . |
| публикация; | educationAssignment | Измените состояние объекта educationAssignment с черновика на опубликовано. |
| Настройка папки ресурсов назначения | string | Создайте папку SharePoint (в предопределенном расположении) для отправки файлов в качестве ресурсов назначения. |
| Настройка папки ресурсов обратной связи о назначении | educationAssignment | Создайте папку SharePoint для отправки файлов отзывов для данного educationSubmission. |
| Вывод списка ресурсов | Коллекция educationAssignmentResource | Получение коллекции объектов educationAssignmentResource . |
| Вывод списка отправленных данных | educationSubmission collection | Получение коллекции объектов educationSubmission . |
| Перечисление категорий | Коллекция educationCategory | Получение коллекции объектов educationCategory . |
| Добавление категорий | educationCategory | Назначьте этому заданию категорию educationCategory , принадлежащую классу. |
| Удаление категории | Нет | Удалите из этого заданияобъект educationCategory, принадлежащий классу. |
| Прикрепление рубрики | Нет | Прикрепите к этому заданию существующую educationRubric. |
| Удаление рубрики | Нет | Отсоедините educationRubric от этого назначения. |
| Получение дельты | Коллекция educationAssignment | Получение списка вновь созданных или обновленных назначений без необходимости полного считывания коллекции. |
| Добавление educationGradingCategory | educationGradingCategory | Добавьте gradingCategory путем публикации в коллекции gradingCategory. |
| Удаление educationGradingCategory | Нет | Удалите объект educationGradingCategory . |
| Активация назначения | educationAssignment | Активируйте неактивную команду educationAssignment , чтобы сообщить о том, что в задании есть дополнительные элементы действий для преподавателей или учащихся. |
| Деактивация назначения | educationAssignment | Пометьте назначенный educationAssignment как неактивный, чтобы сообщить, что в задании нет дополнительных элементов действий как для преподавателей, так и для учащихся. |
Свойства
| Свойство | Тип | Описание |
|---|---|---|
| addedStudentAction | String | Необязательное поле для управления поведением заданий для учащихся, которые добавляются после публикации задания . Если значение не указано, по умолчанию используется значение none. Поддерживаемые значения: none, assignIfOpen. Например, преподаватель может использовать assignIfOpen , чтобы указать, что задание должно быть назначено любому новому учащемуся, который присоединяется к классу, пока задание еще открыто, и none чтобы указать, что задание не должно быть назначено новым учащимся. |
| addToCalendarAction | educationAddToCalendarOptions | Необязательное поле для управления поведением заданий для добавления заданий в календари учащихся и преподавателей при публикации задания . Возможные значения: none, studentsAndPublisher, studentsAndTeamOwners, unknownFutureValueи studentsOnly. Необходимо использовать Prefer: include-unknown-enum-members заголовок запроса, чтобы получить следующие значения в этом развиваемом перечислении: studentsOnly. Значение по умолчанию — none. |
| allowLateSubmissions | Логический | Определяет, могут ли учащиеся отправлять заявки после истечения срока выполнения. Если это свойство не указано во время создания, по умолчанию оно имеет значение true. |
| allowStudentsToAddResourcesToSubmission | Логический | Определяет, могут ли учащиеся добавлять собственные ресурсы в отправку или могут ли они изменять только ресурсы, добавленные преподавателем. |
| assignDateTime | DateTimeOffset | Дата, когда назначение должно стать активным. Если в будущем задание не отображается учащемуся до этой даты. Тип Timestamp представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. |
| assignTo | educationAssignmentRecipient | Какие пользователи или весь класс должны получать объект отправки после публикации назначения . |
| assignedDateTime | DateTimeOffset | Момент публикации задания учащимся и его выполнение отображается на временная шкала учащихся. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. |
| classId | String | Класс, которому принадлежит это назначение . |
| closeDateTime | DateTimeOffset | Дата закрытия назначения для отправки. Это необязательное поле, которое может иметь значение NULL, если назначение не разрешаетLateSubmissions или значение closeDateTime совпадает с dueDateTime. Но если указано значение, значение closeDateTime должно быть больше или равно dueDateTime. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. |
| createdBy | identitySet | Кто создал назначение. |
| createdDateTime | DateTimeOffset | Момент создания назначения . Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. |
| displayName | String | Имя назначения. |
| dueDateTime | DateTimeOffset | Дата окончания срока выполнения задания учащихся. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. |
| feedbackResourcesFolderUrl | String | URL-адрес папки, где хранятся все ресурсы файла отзывов для этого назначения . |
| Профилирования | educationAssignmentGradeType | Как будет оцениваться задание . |
| id | String | Уникальный идентификатор назначения. Наследуется от сущности. Только для чтения. |
| Инструкции | itemBody | Инструкции по назначению. Это свойство и отображаемое имя сообщают учащемуся, что делать. |
| lastModifiedBy | identitySet | Кто в последний раз изменял назначение. |
| lastModifiedDateTime | DateTimeOffset | Дата и время изменения назначения . Отправка учащегося не изменяет задание; Только преподаватели могут обновлять задания. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. |
| moduleUrl | string | URL-адрес модуля, из которого требуется получить доступ к назначению. |
| notificationChannelUrl | String | Необязательное поле для указания URL-адреса канала для отправки уведомления о публикации назначения . Если значение не указано или значение NULL, по умолчанию используется General канал. Это поле применяется только к назначениям, где значением assignTo является educationAssignmentClassRecipient. Обновление notificationChannelUrl запрещено после публикации назначения . |
| resourcesFolderUrl | string | URL-адрес папки, где хранятся все файловые ресурсы для этого назначения . |
| status | string | Состояние назначения. Вы не можете установить исправление этого значения. Возможные значения: draft, scheduled, published, assigned, unknownFutureValue, inactive. Необходимо использовать Prefer: include-unknown-enum-members заголовок запроса, чтобы получить следующие значения в этом развиваемом перечислении: inactive. |
| webUrl | string | URL-адрес прямой ссылки для заданного назначения. |
Связи
| Связь | Тип | Описание |
|---|---|---|
| resources | Коллекция educationAssignmentResource | Объекты обучения, связанные с этим назначением. Изменить этот список могут только преподаватели. Допускается значение null. |
| Представлений | educationSubmission collection | После публикации для каждого учащегося есть объект отправки , представляющий его работу и оценку. Только для чтения. Допускается значение null. |
| categories | Коллекция educationCategory | Если этот параметр задан, пользователи могут легко находить назначения заданного типа. Только для чтения. Допускается значение null. |
| Рубрика | educationRubric | Если задано значение , то к этому заданию прилагается рубрика оценки. |
| gradingCategory | Коллекция educationGradingCategory | Если задано значение , пользователи могут по-разному весить назначения при вычислении среднего класса. |
Представление JSON
В следующем представлении JSON показан тип ресурса.
{
"addedStudentAction": "String",
"addToCalendarAction": "String",
"allowLateSubmissions": "Boolean",
"allowStudentsToAddResourcesToSubmission": "Boolean",
"assignDateTime": "String (timestamp)",
"assignTo": {"@odata.type": "microsoft.graph.educationAssignmentRecipient"},
"assignedDateTime": "String (timestamp)",
"classId": "String",
"closeDateTime": "String (timestamp)",
"createdBy": {"@odata.type": "microsoft.graph.identitySet"},
"createdDateTime": "String (timestamp)",
"displayName": "String",
"dueDateTime": "String (timestamp)",
"feedbackResourcesFolderUrl": "String",
"grading": {"@odata.type": "microsoft.graph.educationAssignmentGradeType"},
"id": "String (identifier)",
"instructions": {"@odata.type": "microsoft.graph.itemBody"},
"lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
"lastModifiedDateTime": "String (timestamp)",
"moduleUrl": "String",
"notificationChannelUrl": "String",
"resourcesFolderUrl": "String",
"status": "String",
"webUrl": "String"
}