Тип ресурса educationAssignment

Пространство имен: microsoft.graph

Представляет задачу или единицу работы, назначенную учащемуся или участнику команды в классе в рамках его исследования.

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

При создании назначения оно находится в состоянии черновика. Учащиеся не видят задание, и отправок не создаются. Состояние назначения можно изменить с помощью действия публикации . Вы не можете использовать запрос PATCH для изменения состояния назначения .

API-интерфейсы назначения предоставляются в пространстве имен класса.

Наследует от сущности.

Методы

Метод	Возвращаемый тип	Описание
Создание	educationAssignment	Создайте новое назначение.
Получение	educationAssignment	Чтение свойств и связей объекта educationAssignment .
Обновление	educationAssignment	Обновление объекта educationAssignment .
Delete	Нет	Удаление объекта educationAssignment .
публикация;	educationAssignment	Измените состояние объекта educationAssignment с черновика на опубликовано.
Создание ресурса задания	educationAssignmentResource	Создайте ресурс назначения.
Получение ресурса задания	educationAssignmentResource	Получение свойств ресурса назначения образования , связанного с заданием.
Удаление ресурса назначения	Нет	Удаление определенного ресурса назначения образования , присоединенного к заданию.
Настройка папки ресурсов назначения	string	Создайте папку SharePoint (в предопределенном расположении) для отправки файлов в качестве ресурсов назначения.
Настройка папки ресурсов обратной связи о назначении	educationAssignment	Создайте папку SharePoint для отправки файлов отзывов для данного educationSubmission.
Вывод списка ресурсов	Коллекция educationAssignmentResource	Получение коллекции объектов educationAssignmentResource .
Вывод списка отправленных данных	educationSubmission collection	Получение коллекции объектов educationSubmission .
Перечисление категорий	Коллекция educationCategory	Получение коллекции объектов educationCategory .
Добавление категорий	educationCategory	Назначьте этому заданию категорию educationCategory , принадлежащую классу.
Удаление категории	Нет	Удалите из этого задания объект educationCategory , принадлежащий классу.
Прикрепление рубрики	Нет	Прикрепите к этому заданию существующую educationRubric .
Удаление рубрики	Нет	Отсоедините educationRubric от этого назначения.
Получение дельты	Коллекция educationAssignment	Получение списка вновь созданных или обновленных объектов educationAssignment без необходимости полного считывания коллекции.
Добавление категории оценки	educationGradingCategory	Добавьте gradingCategory в educationAssignment.
Удаление категории оценок	Нет	Удалите категорию gradingCategory из объекта educationAssignment.
Активация назначения	educationAssignment	inactive Активируйте educationAssignment, чтобы сообщить о том, что задание содержит дополнительные элементы действий для преподавателей или учащихся.
Деактивация назначения	educationAssignment	Пометьте assignededucationAssignment как inactive сигнал о том, что задание не содержит элементов дальнейших действий для преподавателей и учащихся.
Добавление схемы оценки	educationGradingScheme	Добавьте существующий educationGradingScheme к существующему объекту 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	Инструкции по назначению. Инструкции и отображаемое имя сообщают учащемуся, что делать.
languageTag	String	Указывает язык, на котором отображаются уведомления пользовательского интерфейса для назначения. Если languageTag не указан, языком по умолчанию является en-US. Необязательный параметр.
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	educationAssignmentStatus	Состояние назначения. Вы не можете установить исправление этого значения. Допустимые значения: draft, scheduled, published, assigned, unknownFutureValue, inactive. Prefer: include-unknown-enum-members Используйте заголовок запроса, чтобы получить следующие члены в этой развиваемой перечислении: inactive.
webUrl	string	URL-адрес прямой ссылки для заданного назначения.

Связи

Связь	Тип	Описание
categories	Коллекция educationCategory	Если этот параметр задан, пользователи могут легко находить назначения заданного типа. Только для чтения. Допускается значение null.
gradingCategory	Коллекция educationGradingCategory	Если задано значение , пользователи могут по-разному весить назначения при вычислении среднего класса.
gradingScheme	educationGradingScheme	Если этот параметр задан, позволяет пользователям настраивать пользовательские строковые оценки на основе процента от общего количества баллов, полученных за это назначение.
resources	Коллекция educationAssignmentResource	Объекты обучения, связанные с этим назначением. Изменить этот список могут только преподаватели. Допускается значение null.
рубрика	educationRubric	Если задано значение , то к этому заданию прилагается рубрика оценки.
Представлений	educationSubmission collection	После публикации для каждого учащегося появится объект отправки , представляющий его работу и оценку. Только для чтения. Допускается значение null.

Представление 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"},
  "languageTag": "String",
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "moduleUrl": "String",
  "notificationChannelUrl": "String",
  "resourcesFolderUrl": "String",
  "status": "String",  
  "webUrl": "String"
}