Usar o Graph Explorer para trabalhar com a API de educação no Microsoft Graph

Você pode usar a API de educação no Microsoft Graph para criar aplicativos que acessam dados EDU. Por exemplo, você pode exibir informações do SDS (Sincronização de Dados Escolares) e do Microsoft Teams ou automatizar tarefas comuns, como adicionar alunos e criar atribuições.

Você pode usar o Graph Explorer para testar consultas do Microsoft Graph antes de implementá-las em seu aplicativo.

Use as seguintes etapas para tentar chamadas de API de educação no Graph Explorer:

1. Abra um navegador da Web privado, vá para developer.microsoft.com/en-us/graph/graph-explorer, escolha Entrar no Graph Explorer e insira suas credenciais de conta Administração Global Office 365.

2. Para acessar a API de listagem, conceda as permissões correspondentes ao Graph Explorer. Acesse Modificar permissões, pesquise EduRoster.ReadBasic e escolha Consentimento.

   Talvez seja necessário aguardar as permissões para atualizar antes de executar todas as consultas.

3. Para obter uma lista de suas escolas, no campo consulta, insira https://graph.microsoft.com/v1.0/education/schools e escolha Executar consulta.

4. Para obter uma lista de classes, no campo consulta, insirahttps://graph.microsoft.com/v1.0/education/classes e escolha Executar consulta.

5. Pegue a ID 740202c8-5db7-4496-a055-9f3c9fd98207 da primeira classe para obter as atribuições dessa classe. No campo consulta, insira https://graph.microsoft.com/v1.0/education/classes/740202c8-5db7-4496-a055-9f3c9fd98207/assignmentse escolha Executar consulta.

6. Para acessar a API de atribuições, conceda as permissões correspondentes ao Graph Explorer. Acesse Modificar permissões, pesquise EduAssignments.Read, EduAssignments.ReadBasic, EduAssignments.ReadWrite e EduAssignments.ReadWriteBasic e escolha Consentimento.

7. Execute a consulta para obter as atribuições.

8. Agora você pode tentar criar uma nova atribuição. No campo de consulta, insira https://graph.microsoft.com/v1.0/education/classes/740202c8-5db7-4496-a055-9f3c9fd98207/assignments. Verifique se POST está selecionado para o tipo de solicitação.

9. No campo Corpo da solicitação , cole o JSON a seguir.

   ```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. Escolha Executar consulta. Se a consulta for bem-sucedida, você receberá uma Created – 201 resposta e um objeto JSON que representa a nova atribuição.

    

11. Experimente mais consultas. Para obter mais exemplos, consulte o conteúdo de referência da API de educação.

Próxima etapa

Como trabalhar com APIs de educação no Microsoft Graph