Partager via

Utilisation des API d’enseignement dans Microsoft Graph

  • Article

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’éducation 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. Votre application a également besoin des autorisations appropriées. Pour plus d’informations, reportez-vous à la rubrique Autorisations d’enseignement.

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 d’«Enseignant».
  • educationStudent : représente les utilisateurs dotés du rôle principal d’«Étudiant».

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

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 :

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

Classwork

Vous pouvez utiliser Classwork comme un guichet unique pour créer et organiser des ressources de classe, notamment des devoirs, des pages de bloc-notes OneNote pour la classe, des liens web, des fichiers et des canaux Teams. Cela signifie que vous n’avez plus besoin de naviguer dans plusieurs applications et plateformes pour trouver ce dont vous avez besoin. Avec Classwork, vous pouvez organiser une vue du contenu et des ressources qui permet à vos étudiants de naviguer dans la classe et de tout voir au même endroit.

L’API Classwork fournit les ressources clés suivantes :

  • educationModule : un module est associé à une classe. Représente un groupe de ressources d’apprentissage individuelles organisées de manière systématique.
  • educationModuleResource : objet wrapper qui stocke les ressources associées à un module. L’étudiant ne peut pas mettre à jour cette ressource, qui est un document de l’enseignant à l’étudiant sans rien à retourner.

Les listes suivantes présentent les scénarios pris en charge par l’API Classwork.

Modules

La ressource educationModule prend en charge les scénarios suivants :

Ressources de module

La ressource educationModuleResource prend en charge les scénarios suivants :

Cas d’utilisation courants

Le tableau suivant présente certains cas d’usage courants pour les API d’éducation liées aux modules.

Cas d’utilisation Description Voir aussi
Créer un module Seuls les enseignants d’une classe peuvent créer un module. Les modules commencent à l’état brouillon, ce qui signifie que les étudiants ne voient pas les modules avant leur publication. Créer educationModule
Lister les modules Un enseignant ou une application disposant d’autorisations d’application peut voir tous les objets de module pour la classe. Les étudiants peuvent uniquement voir les modules publiés. Répertorier les modules de classe
Publier un module Change l’état d’un educationModule de son état d’origine draft à l’état published . educationModule : publier
Créer une ressource dans un module Seuls les enseignants peuvent effectuer cette opération. Créer educationModuleResource
Répertorier les ressources de module Obtenez tous les objets educationModuleResource associés à un module. Seuls les enseignants, les étudiants et les applications disposant d’autorisations d’application peuvent effectuer cette opération. Répertorier les ressources de module

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 l’ID Microsoft Entra 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 :

É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.