Использование Обозреватель Graph для работы с API образования в Microsoft Graph

API для образования в Microsoft Graph можно использовать для создания приложений, которые обращаются к данным EDU. Например, можно отобразить сведения из School Data Sync (SDS) и Microsoft Teams или автоматизировать распространенные задачи, такие как добавление учащихся и создание заданий.

Вы можете использовать Обозреватель Graph для тестирования запросов Microsoft Graph перед их реализацией в приложении.

Чтобы попробовать вызовы API для образовательных учреждений в Graph Обозреватель, выполните следующие действия.

1. Откройте частный веб-браузер, перейдите в developer.microsoft.com/en-us/graph/graph-explorer, выберите Вход в Graph Обозреватель и введите учетные данные учетной записи Office 365 администратора.

2. Чтобы получить доступ к API создания списка, предоставьте соответствующие разрешения Обозреватель Graph. Перейдите в раздел Изменение разрешений, найдите EduRoster.ReadBasic и выберите Согласие.

   Возможно, вам придется дождаться обновления разрешений, прежде чем выполнять все запросы.

3. Чтобы получить список учебных заведений, в поле запроса введите https://graph.microsoft.com/v1.0/education/schools и выберите Выполнить запрос.

4. Чтобы получить список классов, в поле запроса введите https://graph.microsoft.com/v1.0/education/classes и выберите Выполнить запрос.

5. Возьмите идентификатор 740202c8-5db7-4496-a055-9f3c9fd98207 первого класса, чтобы получить назначения этого класса. В поле запроса введите https://graph.microsoft.com/v1.0/education/classes/740202c8-5db7-4496-a055-9f3c9fd98207/assignmentsи выберите Выполнить запрос.

6. Чтобы получить доступ к API назначений, предоставьте соответствующие разрешения Обозреватель Graph. Перейдите в раздел Изменение разрешений, найдите EduAssignments.Read, EduAssignments.ReadBasic, EduAssignments.ReadWrite и EduAssignments.ReadWriteBasic и выберите Согласие.

7. Выполните запрос, чтобы получить назначения.

8. Теперь можно попробовать создать новое назначение. В поле запроса введите https://graph.microsoft.com/v1.0/education/classes/740202c8-5db7-4496-a055-9f3c9fd98207/assignments. Убедитесь, что для типа запроса выбран параметр POST.

9. В поле Текст запроса вставьте следующий код 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
   }
   

10. Выберите Выполнить запрос. Если запрос выполнен успешно, вы получите Created – 201 ответ и объект JSON, представляющий новое назначение.

    

11. Попробуйте выполнить дополнительные запросы. Дополнительные примеры см. в справочном содержимом API для образовательных учреждений.

Следующее действие