Тип ресурса 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 Boolean Определяет, могут ли учащиеся отправлять заявки после истечения срока выполнения. Если это свойство не указано во время создания, по умолчанию оно имеет значение true.
allowStudentsToAddResourcesToSubmission Boolean Определяет, могут ли учащиеся добавлять собственные ресурсы в отправку или могут ли они изменять только ресурсы, добавленные преподавателем.
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"
 
}