Поделиться через


Использование Обозреватель 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, представляющий новое назначение.

    Снимок экрана: запрос и ответ на создание запроса назначения в Обозреватель Graph

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

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