Utilisation des API d’enseignement dans Microsoft Graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Les API d’éducation de Microsoft Graph améliorent les ressources et les données Microsoft 365 avec des informations pertinentes pour les scénarios d’éducation, notamment les écoles, les étudiants, les enseignants, les classes, les inscriptions et les devoirs. Cela simplifie la création de solutions qui s’intègrent aux ressources pédagogiques.

Les API d’éducation incluent des ressources de mise en liste et des ressources de devoirs que vous pouvez utiliser pour interagir avec les services de mise en liste et d’affectation dans Microsoft Teams. Vous pouvez utiliser ces ressources pour gérer une liste scolaire et automatiser les devoirs des étudiants.

Autorisation

Pour appeler les API d’enseignement dans Microsoft Graph, votre application doit acquérir un jeton d’accès. Pour plus d’informations sur les jetons d’accès, reportez-vous à l’article Obtenir des jetons d’accès pour appeler Microsoft Graph. Elle doit également disposer des autorisations appropriées. Pour plus d’informations, reportez-vous à la rubrique Autorisations d’enseignement.

Autorisations des applications nécessitant le consentement des administrateurs informatiques d’établissements scolaires

Pour déployer les applications intégrées aux API d’enseignement dans Microsoft Graph, les administrateurs informatiques d’établissements scolaires doivent tout d’abord accorder leur consentement aux autorisations demandées par l’application. Ce consentement ne doit être accordé qu’une seule fois, sauf si les autorisations changent. Une fois que l’administrateur a donné son consentement, l’application est mise en service pour tous les utilisateurs dans le client.

Pour déclencher une boîte de dialogue de consentement, utilisez l’appel REST suivant.

GET https://login.microsoftonline.com/{tenant}/adminconsent?
client_id={clientId}&state=12345&redirect_uri={redirectUrl}

Paramètre	Description
Client	ID de client de l’établissement scolaire. Utilisez l’ID complet, qui inclut onmicrosoft.com.
clientId	ID de client de l’application.
redirectUrl	URL de redirection de l’application.

Création de listes de présence

Les API de création de listes de présence permettent d’extraire des données du client Microsoft 365 d’un établissement scolaire mis en service avec Microsoft School Data Sync. Ces API fournissent l’accès à des informations sur les établissements scolaires, les sections, les enseignants, les étudiants et les listes de présence. Les API prennent en charge des scénarios application seule (synchronisation) et des scénarios application + utilisateur (interactifs). Les API qui prennent en charge les scénarios interactifs appliquent des stratégies RBAC appropriées à la région qui reposent sur le rôle utilisateur appelant l’API. Cela fournit une API cohérente et une surface de stratégie minimale, quelle que soit la configuration administrative au sein de clients. En outre, les API fournissent également des autorisations spécifiques de l’enseignement pour vous assurer que le bon utilisateur a accès aux données.

Vous pouvez utiliser les API de création de listes de présence pour permettre à un utilisateur d’application d’avoir les réponses aux questions suivantes :

• Qui suis-je ?
• À quelles classes je participe ou j’enseigne ?
• Que dois-je faire et dans quel délai ?

Les API de création de listes de présence fournissent les ressources clés suivantes :

• educationSchool : représente l’établissement scolaire.
• educationClass : représente une classe dans un établissement scolaire.
• educationTerm : représente une partie désignée de l’année scolaire.
• educationTeacher : représente les utilisateurs dotés du rôle principal « Enseignant ».
• educationStudent : représente les utilisateurs dotés du rôle principal « Étudiant ».

Les API de création de listes de présence prennent en charge les scénarios suivants :

• Répertorier tous les établissements scolaires
• Répertorier les établissements scolaires dans lesquels une classe est assurée
• Répertorier les établissements scolaires pour un utilisateur
• Obtenir toutes les classes
• Obtenir les classes d’un établissement scolaire
• Répertorier les classes pour un utilisateur
• Ajouter des classes à un établissement scolaire
• Obtenir les étudiants et les enseignants pour une classe
• Ajouter des membres à une classe
• Répertorier les enseignants pour une classe
• Obtenir des utilisateurs dans un établissement scolaire

Devoirs

Vous pouvez utiliser les API d’éducation liées aux devoirs pour les intégrer aux devoirs dans Microsoft Teams. Microsoft Teams dans Microsoft 365 Éducation est basé sur les mêmes API éducation et fournit un cas d’utilisation pour ce que vous pouvez faire avec les API. Votre application peut utiliser ces API pour interagir avec les devoirs tout au long du cycle de vie des devoirs.

Les API de devoir fournissent les ressources clés suivantes :

• educationAssignment : objet principal de l’API de devoirs. Représente une tâche ou une unité de travail affectée à un étudiant ou à un membre de l’équipe d’une classe dans le cadre de son étude.
• educationSubmission : représente les ressources qu’un individu (ou un groupe) soumet pour un devoir, ainsi que la note et les commentaires associés pour ces devoirs.
• educationResource : représente l’objet d’apprentissage qui est affecté ou envoyé. Un educationResource est associé à uneducationAssignment et/ou à uneducationSubmission.

Les API d’affectation prennent en charge les scénarios suivants :

• Créer un devoir
• Publier le devoir
• Créer une ressources de devoirs
• Créer une ressource de soumission
• Envoyer les devoirs
• Retrait des devoirs
• Renvoyer des notes et des commentaires à l’étudiant
• Obtenir les détails des devoirs

Voici quelques cas d’usage courants pour les API d’éducation liées aux devoirs.

Cas d’utilisation	Description	Voir aussi
Créer des devoirs	Un système externe peut créer un devoir pour la classe et attacher des ressources aux devoirs.	Créer un devoir
Lire les informations de devoirs	Une application analytique peut obtenir des informations sur les devoirs et les soumissions d’étudiants, notamment les dates et les notes.	Obtenir un devoir
Suivre les devoirs d’étudiants	Votre application peut fournir un tableau de bord d’enseignant qui indique le nombre de devoirs d’étudiants à noter.	Ressource de devoirs

Gestion de la synchronisation des données scolaires

School Data Sync permet d’automatiser le processus d’importation et de synchronisation des données de liste à partir des systèmes d’information des étudiants avec Microsoft Entra ID et Microsoft 365. Vous pouvez utiliser les API de gestion de la synchronisation des données scolaires dans Microsoft Graph pour configurer la synchronisation à partir d’un fichier CSV ou d’un connecteur d’API SIS pris en charge.

Les API de gestion de synchronisation des données scolaires prennent en charge les scénarios suivants :

• Répertorier les profils de synchronisation
• Obtenir le profil de synchronisation
• Créer un profil de synchronisation
• Supprimer le profil de synchronisation
• Suspendre une synchronisation en cours
• Reprendre une synchronisation suspendue
• Réinitialiser une synchronisation
• Démarrer la synchronisation des fichiers chargés
• Obtenir une URL de chargement
• Obtenir status d’une synchronisation
• Obtenir les erreurs de synchronisation

Étapes suivantes

Utilisez les API d’éducation Microsoft Graph pour créer des solutions d’éducation qui accèdent aux devoirs des étudiants et aux listes scolaires. Pour en savoir plus :

• Explorez les ressources et les méthodes les plus utiles à votre scénario.
• Essayez l’API dans l’Afficheur Graph.