Abrufen von Zuweisungs- und Noteninformationen für Bildungslösungen

Bildungseinrichtungen verfügen über benutzerdefinierte Tools, die Daten aus Aufgaben und Noten benötigen. Beispielsweise Tools, die für die Berichterstellung und Kommunikation mit dem Schulbezirk verwendet werden, oder Tools, die zum Automatisieren einer Reihe von Prozessen verwendet werden. Sie können die Bildungs-API in Microsoft Graph verwenden, um Daten für Aufgaben und Noten für Klassen und Schüler abzurufen.

Hinweis: Sie können den Graph-Explorer verwenden, um die in diesem Artikel erwähnten APIs zu testen.

Abrufen von Klassen- und Memberinformationen

Aufgaben- und Bewertungsinformationen sind Teil des Teams in Microsoft Teams. Mithilfe der folgenden APIs können Sie Informationen zu Kursen, Mitgliedern und Rollen (Kursteilnehmer oder Lehrer) in einem Team abrufen:

• Klassen einer educationSchools auflisten: Gibt eine Liste aller Kurse in Ihrem Education-Mandanten zurück.
• Member einer educationClass auflisten: Listet Informationen zu Mitgliedern einer bestimmten Klasse auf.

Nachdem Sie die relevanten Kurs- und Mitgliedsinformationen erhalten haben, können Sie die aufgaben- und notenrelevanten Informationen abrufen, die Sie benötigen.

Abrufen von Klassenzuweisungsinformationen

Alle Aufgaben und Informationen der Kursteilnehmer sind mit Kurs- bzw. Übermittlungsinformationen verknüpft. Sie können die folgenden APIs verwenden, um Informationen zu Klassenzuweisungen abzurufen:

• educationAssignment-Ressourcentyp: Ermöglicht ihnen, alle Daten für Aufgaben in einer Klasse aufzulisten und anzuzeigen.
• educationSubmission-Ressourcentyp: Für jeden Kursteilnehmer, für den eine Aufgabe veröffentlicht wird, wird eine Übermittlung erstellt. Sie können diese API verwenden, um den Übermittlungsstatus abzurufen, d. h., ob sie abgegeben und bewertet wurde, vom Kursteilnehmer übermittelte Ressourcen und die Note (Ergebnis) für die Übermittlung.

Abrufen von Informationen zu Kursteilnehmer*innen

Ein Schüler befindet sich häufig in mehreren Klassen innerhalb einer Schule, und Sie müssen die Daten für den Kursteilnehmer häufig klassenübergreifend anzeigen. Sie können die folgende API verwenden, um Kursteilnehmerdaten klassenübergreifend anzuzeigen:

• Auflisten von Zuweisungen eines Benutzers: Listet alle Zuweisungen für einen bestimmten Benutzer auf. Sie können dies entweder von einem delegierten Benutzer verwenden, oder die bevorzugte Methode besteht darin, eine AppOnly-Person zu verwenden, um zu verwenden /users/{user-id}.

Berechtigungen

Die Zuweisungs-API unterstützt sowohl delegierte (pro Benutzer) als auch nur App-Berechtigung (pro App). Nur-App-Berechtigungen vereinfachen die Erfahrung für Schüler und Lehrer, da sie die App nur genehmigen müssen, um Daten abzurufen.

Aktualisierungen zu den Daten

Im Laufe des Schuljahres wird es Aktualisierungen der Aufgaben geben, da Lehrer und Schüler weiterhin daran arbeiten. Alle Education-APIs unterstützen Deltaabfragen, sodass Sie Änderungen seit der letzten Abfrage des API-Endpunkts nachverfolgen können.

Für Zuweisungen werden Deltaabfragen nur für Änderungen an Zuweisungsinformationen und nicht für Übermittlungsänderungen für eine Zuweisung unterstützt.

Filtern von Daten

Zuweisungs-API-Endpunkte geben eine große Menge an Daten zurück. Sie können den Filter-OData-Abfrageparameter verwenden, um die Daten nach Bedarf zu verarbeiten.