Получение сведений о присвоении и оценке для образовательных решений

  • Статья

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

Примечание: Вы можете использовать Обозреватель Graph для тестирования API, упомянутых в этой статье.

Получение сведений о классах и членах

Сведения о заданиях и оценках входят в состав команды в Microsoft Teams. Сведения о классах, участниках и ролях (учащегося или преподавателя) в команде можно получить с помощью следующих API:

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

Получение сведений о назначении класса

Все задания и сведения учащихся связаны с данными о классе и отправке соответственно. Для получения сведений о назначениях классов можно использовать следующие API:

  • Тип ресурса educationAssignment. Позволяет выводить список и просматривать все данные для заданий в классе.
  • Тип ресурса educationSubmission. Отправка создается для каждого учащегося, для которого опубликовано задание. Этот API можно использовать для получения состояния отправки, т. е. о том, была ли она передана и оценивалась, ресурсы , отправленные учащимся, а также оценку (результат) для отправки.

Получение сведений о задании учащегося

Учащийся часто находится в нескольких классах в пределах школы, и вам часто нужно видеть данные для учащегося в разных классах. Для просмотра данных учащихся в разных классах можно использовать следующий API:

  • Список назначений пользователя: Списки всех назначений для данного пользователя. Вы можете использовать этот параметр делегированным пользователем или предпочтительный способ — использовать пользователя AppOnly для использования /users/{user-id}.

Разрешения

API назначений поддерживает делегированные разрешения (для каждого пользователя) и только для приложения (для каждого приложения). Разрешения только для приложений упрощают работу учащихся и преподавателей, так как они должны утвердить приложение только для получения данных.

Обновления данных

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

Для назначений разностные запросы поддерживаются только для изменения сведений о назначении, а не для отправки изменений для назначения.

Фильтрация данных

Конечные точки API назначения возвращают большой объем данных. Для обработки данных по мере необходимости можно использовать параметр запроса ODataфильтра.

Связанные материалы