Получение сведений о присвоении и оценке для образовательных решений
Образовательные учреждения имеют пользовательские инструменты, которым требуются данные из заданий и оценок; например, средства, используемые для создания отчетов и обмена данными с школьным округом, или средства, используемые для автоматизации набора процессов. API для образовательных учреждений в Microsoft Graph можно использовать для получения данных о заданиях и оценках как для классов, так и для учащихся.
Примечание: Вы можете использовать Graph Explorer для тестирования API, упомянутых в этой статье.
Получение сведений о классах и членах
Сведения о заданиях и оценках входят в состав команды в Microsoft Teams. Сведения о классах, участниках и ролях (учащегося или преподавателя) в команде можно получить с помощью следующих API:
- Список классов educationSchools. Возвращает список всех классов в клиенте для образовательных учреждений.
- Список членов educationClass: список сведений об участниках определенного класса.
После получения соответствующих сведений о классе и участниках вы можете получить необходимые сведения о задании и оценок.
Получение сведений о назначении класса
Все задания и сведения учащихся связаны с данными о классе и отправке соответственно. Для получения сведений о назначениях классов можно использовать следующие API:
- Тип ресурса educationAssignment. Позволяет выводить список и просматривать все данные для заданий в классе.
- Тип ресурса educationSubmission. Отправка создается для каждого учащегося, для которого опубликовано задание. Этот API можно использовать для получения состояния отправки, т. е. для получения сведений о том, была ли она передана и оценивалась, ресурсы , отправленные учащимся, а также оценку (результат) для отправки.
Получение сведений о задании учащегося
Учащийся часто находится в нескольких классах в пределах школы, и вам часто нужно видеть данные для учащегося в разных классах. Для просмотра данных учащихся в разных классах можно использовать следующий API:
- Список назначений пользователя: список всех назначений для данного пользователя. Вы можете использовать этот параметр делегированным пользователем или предпочтительный способ — использовать пользователя AppOnly для использования
/users/{user-id}.
Разрешения
API назначений поддерживает делегированные разрешения (для каждого пользователя) и только для приложения (для каждого приложения). Разрешения только для приложений упрощают работу учащихся и преподавателей, так как они должны утвердить приложение только для получения данных.
Обновления данных
В течение учебного года будут обновлены задания, как учителя и учащиеся продолжают работать над ними. Все API для образовательных учреждений поддерживают разностные запросы, что позволяет отслеживать изменения с момента последнего запроса к конечной точке API.
Для назначений разностные запросы поддерживаются только для изменения сведений о назначении, а не для отправки изменений для назначения.
Фильтрация данных
Конечные точки API назначения возвращают большой объем данных. Для обработки данных по мере необходимости можно использовать параметр запроса ODataфильтра.