Obtenir des informations sur les attributions et les notes pour les solutions d’éducation

Article
03/15/2023
2 minutes de lecture

Les établissements d’enseignement disposent d’outils personnalisés qui ont besoin de données sur les devoirs et les notes; par exemple, les outils utilisés pour la création de rapports et la communication avec le district scolaire, ou les outils utilisés pour automatiser un ensemble de processus. Vous pouvez utiliser l’API éducation dans Microsoft Graph pour obtenir des données pour les devoirs et les notes des classes et des étudiants.

Note: Vous pouvez utiliser l’Explorateur Graph pour tester les API mentionnées dans cet article.

Obtenir des informations sur les classes et les membres

Les informations sur les devoirs et les notes font partie de l’équipe de Microsoft Teams. Vous pouvez obtenir des informations sur les classes, les membres et les rôles (étudiants ou enseignants) dans une équipe à l’aide des API suivantes :

Répertorier les classes d’un educationSchools : renvoie une liste de toutes les classes de votre locataire Éducation.
Répertorier les membres d’une classe educationClass : répertorie des informations sur les membres d’une classe spécifique.

Une fois que vous avez obtenu les informations de classe et de membre pertinentes, vous pouvez obtenir les informations de devoir et de note dont vous avez besoin.

Obtenir des informations sur les affectations de classe

Tous les devoirs et les informations des étudiants sont liés aux informations de classe et de soumission, respectivement. Vous pouvez utiliser les API suivantes pour récupérer des informations sur les affectations de classes :

Type de ressource educationAssignment : vous permet de répertorier et d’afficher toutes les données pour les devoirs d’une classe.
Type de ressource educationSubmission : une soumission est créée pour chaque étudiant pour lequel un devoir est publié. Vous pouvez utiliser cette API pour obtenir l’état de la soumission, c’est-à-dire si elle a été retournée et notée, les ressources soumises par l’étudiant et la note (résultat) de la soumission.

Obtenir des informations sur les devoirs des étudiants

Un étudiant est souvent dans plusieurs classes au sein d’une école, et vous avez souvent besoin de voir les données de l’étudiant entre les classes. Vous pouvez utiliser l’API suivante pour afficher les données des étudiants entre les classes :

Répertorier les affectations d’un utilisateur : répertorie toutes les affectations d’un utilisateur donné. Vous pouvez utiliser ceci par un utilisateur délégué ou la méthode préférée consiste à utiliser la personne AppOnly pour utiliser /users/{user-id}.

Autorisations

L’API affectations prend en charge à la fois l’autorisation déléguée (par utilisateur) et l’autorisation d’application uniquement (par application). Les autorisations d’application uniquement simplifient l’expérience des étudiants et des enseignants, car ils n’ont qu’à approuver l’application pour récupérer des données.

Mises à jour aux données

Au cours de l’année scolaire, il y aura des mises à jour des devoirs à mesure que les enseignants et les étudiants continuent à travailler dessus. Toutes les API d’éducation prennent en charge la requête delta, ce qui vous permet de suivre les modifications depuis la dernière interrogation du point de terminaison d’API.

Pour les affectations, les requêtes delta sont prises en charge uniquement pour les modifications d’informations d’affectation, et pas pour les modifications de soumission d’une affectation.

Filtrage des données

Les points de terminaison d’API d’affectation retournent une grande quantité de données. Vous pouvez utiliser le paramètre de requête OData de filtre pour gérer les données en fonction des besoins.