Использование Обозреватель Graph для работы с API образования в Microsoft Graph
API для образования в Microsoft Graph можно использовать для создания приложений, которые обращаются к данным EDU. Например, можно отобразить сведения из School Data Sync (SDS) и Microsoft Teams или автоматизировать распространенные задачи, такие как добавление учащихся и создание заданий.
Вы можете использовать Обозреватель Graph для тестирования запросов Microsoft Graph перед их реализацией в приложении.
Чтобы попробовать вызовы API для образовательных учреждений в Graph Обозреватель, выполните следующие действия.
Откройте частный веб-браузер, перейдите в developer.microsoft.com/en-us/graph/graph-explorer, выберите Вход в Graph Обозреватель и введите учетные данные учетной записи Office 365 администратора.
Чтобы получить доступ к API создания списка, предоставьте соответствующие разрешения Обозреватель Graph. Перейдите в раздел Изменение разрешений, найдите EduRoster.ReadBasic и выберите Согласие.
Возможно, вам придется дождаться обновления разрешений, прежде чем выполнять все запросы.
Чтобы получить список учебных заведений, в поле запроса введите
https://graph.microsoft.com/v1.0/education/schools
и выберите Выполнить запрос.Чтобы получить список классов, в поле запроса введите
https://graph.microsoft.com/v1.0/education/classes
и выберите Выполнить запрос.Возьмите идентификатор
740202c8-5db7-4496-a055-9f3c9fd98207
первого класса, чтобы получить назначения этого класса. В поле запроса введитеhttps://graph.microsoft.com/v1.0/education/classes/740202c8-5db7-4496-a055-9f3c9fd98207/assignments
и выберите Выполнить запрос.Чтобы получить доступ к API назначений, предоставьте соответствующие разрешения Обозреватель Graph. Перейдите в раздел Изменение разрешений, найдите EduAssignments.Read, EduAssignments.ReadBasic, EduAssignments.ReadWrite и EduAssignments.ReadWriteBasic и выберите Согласие.
Выполните запрос, чтобы получить назначения.
Теперь можно попробовать создать новое назначение. В поле запроса введите
https://graph.microsoft.com/v1.0/education/classes/740202c8-5db7-4496-a055-9f3c9fd98207/assignments
. Убедитесь, что для типа запроса выбран параметр POST.В поле Текст запроса вставьте следующий код JSON.
{ "dueDateTime": "2024-02-15T00:00:00Z", "displayName": "Reading and comprehension", "instructions": { "contentType": "text", "content": "Read the chapter and answer the questions" }, "grading": { "@odata.type": "#microsoft.graph.educationAssignmentPointsGradeType", "maxPoints": 50 }, "assignTo": { "@odata.type": "#microsoft.graph.educationAssignmentClassRecipient" }, "allowStudentsToAddResourcesToSubmission": true }
Выберите Выполнить запрос. Если запрос выполнен успешно, вы получите
Created – 201
ответ и объект JSON, представляющий новое назначение.Попробуйте выполнить дополнительные запросы. Дополнительные примеры см. в справочном содержимом API для образовательных учреждений.