Utilisation des API d’enseignement dans Microsoft Graph

  • Article

Les API d’enseignement dans Microsoft Graph améliorent les données et les ressources Microsoft 365 en fournissant des informations pertinentes pour les scénarios d’enseignement, y compris sur les établissements scolaires, les étudiants, les enseignants, les classes et les inscriptions. Cela simplifie la création de solutions qui s’intègrent aux ressources pédagogiques.

Les API d’enseignement comprennent des ressources de création de listes de présence et des ressources de devoirs que vous pouvez utiliser pour interagir avec les services de création de listes de présence dans Microsoft Teams. Vous pouvez utiliser ces ressources pour gérer la liste de présence d’un établissement scolaire.

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.

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 afficher 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

Étapes suivantes

Utilisez les API d’enseignement Microsoft Graph pour créer des solutions d’enseignement qui accèdent aux listes de présence d’établissements 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.