Table of contents
TOC
Inhaltsverzeichnis reduzieren
Inhaltsverzeichnis erweitern
Zuletzt aktualisiert: 25.07.2018

Schüler-REST-API-Verweis

Betrifft: Office 365

Diese Dokumentation umfasst Funktionen, die sich derzeit in der Vorschau befinden.

Office 365 Education-APIs helfen bei der Auswahl von Daten Ihres Office 365-Inhabers, die von Microsoft School Data Sync mit der Cloud synchronisiert wurden. Diese Ergebnisse enthalten Informationen über Schulen, Bereiche, Lehrer, Schüler und Dienstplaninformationen. Die Schüler-REST-API bietet Bildungseinrichtungen Zugang zu den Schülerdaten in Office 365.

Die API basiert auf Microsoft Azure Active Directory und OAuth zur Authentifizierung von Anwendungsanfragen.

Um von Ihrer Anwendung aus auf die Schüler-REST-API zuzugreifen, müssen Sie diese in Azure Active Directory registrieren. Sie müssen außerdem Authentifizierungstoken verwalten sowie die richtige URL und Abfragen erstellen, um Ihren Anforderungen gerecht zu werden. Die folgenden Beispiele können Ihnen bei der Erstellung Ihrer Abfragen behilflich sein.

Testen der APIs

Alle Dienstplaninformation-APIs der Schulen können in einer EDU-Umgebung mit Graph-Testergetestet werden. Navigieren Sie zum Graph-Tester, melden Sie sich mit Ihren O365 EDU-Umgebungsdaten an, wählen Sie "Beta" als Version, kopieren Sie die URLs und überprüfen Sie die Antwort.

Alle REST-API-Operationen von Schülern

Die Schüler sind im Azure Active Directory als Benutzer vertreten. Sie können die Informationen des aktuell angemeldeten Schülers erhalten, sowie über die Schule und die Bereiche, an denen der Schüler teilnimmt.

Aktuellen Benutzer abrufen | Schule eines Schülers abrufen | Bereich eines Schülers abrufen

Verwenden der Schüler-REST-API

Um mit der Schüler-REST-API zu interagieren, senden Sie HTTP-Abrufanfragen.

Wenn der angemeldete Benutzer ein Schüler ist, verwenden alle REST-API-Anfragen von Schülern die folgende Stamm-URL:

https://graph.microsoft.com/beta/me/

Die Schüler sind im Azure Active Directory als Benutzer vertreten. Erweiterungsattribute zu den Benutzern fügen schülerspezifische Informationen hinzu.
Beispielsweise enthält das Attribut extension_fe2174665583431c953114ff7268b7b3_Education_Grade die Jahrgangsstufe des Schülers.

Schülerattribute

Die Beschreibung der Attribute, die bei der Identifizierung der Informationen über den Schüler helfen, finden Sie hier: Schülerattribute


Aktuellen Benutzer abrufen

Sie können den aktuellen angemeldeten Benutzer ermitteln und überprüfen, ob dieser Benutzer ein Schüler ist.

GET https://graph.microsoft.com/beta/me/

Antwort-Typ

Aktuell eingeloggter Benutzer.

Prüfen Sie, ob der Schüler

Ein aktuell angemeldeter Benutzer kann ein Schüler, Lehrer oder Nicht-Bildungsbenutzer (z.B. Verwaltungsmitarbeiter) sein. Sie können in Ihrer Anwendung prüfen, ob der Benutzer ein Schüler ist. Abfrage nach dem Education_ObjectType Erweiterungsattribut, das gleich ist mit Student.

extension_fe2174665583431c953114ff7268b7b3_Education_ObjectType == 'Student'

Schule eines Schülers ermitteln

Schulen werden im Azure Active Directory als Administrative Einheitendargestellt. Erweiterungsattribute zu diesen Verwaltungseinheiten fügen schulspezifische Informationen hinzu. Zum Beispiel enthält das Attribut extension_fe2174665583431c953114ff7268b7b3_Education_HighestGrade die höchste Jahrgangsstufe in dieser Schule.

Sie können die Schule des angemeldeten Schülers erhalten, indem Sie die Mitgliedschaft dieses Schülers ermitteln und dann einen Filter setzen auf extension_fe2174665583431c953114ff7268b7b3_Education_ObjectType == 'School' und objectType == 'AdministrativeUnit'

Schülermitgliedschaft ermitteln

Sie können die Mitgliedschaft des angemeldeten Schülers über die unten stehende Abfrage erhalten.

GET https://graph.microsoft.com/beta/me/

Antwort-Typ

Die Antwort umfasst mehrere Gruppen, Verzeichnisrollen und/oder Verwaltungseinheiten, in denen der Schüler Mitglied ist.

Filter für die Schule

Sie können die Schule eines Schülers durch Filtern auf extension_fe2174665583431c953114ff7268b7b3_Education_ObjectType == 'School' und objectType == 'AdministrativeUnit'erhalten.


Bereich eines Schülers erhalten

Bereiche werden im Azure Active Directory als Vereinheitlichte Gruppendargestellt. Erweiterungsattribute auf den vereinheitlichten Gruppen fügen bereichsspezifische Informationen hinzu. Beispielsweise enthält das Attribut extension_fe2174665583431c953114ff7268b7b3_Education_CourseName den Kursnamen für den Bereich.

Schülermitgliedschaft ermitteln

Sie können die Mitgliedschaft des Schülers über die unten stehende Abfrage erhalten.

GET https://graph.microsoft.com/beta/me/

Antwort-Typ

Die Antwort umfasst mehrere Gruppen, Verzeichnisrollen und/oder Verwaltungseinheiten, in denen der Schüler Mitglied ist.

Filter für Bereich

Sie können den Bereich eines Schülers durch Filtern auf extension_fe2174665583431c953114ff7268b7b3_Education_ObjectType == 'Section' und objectType == 'Group'erhalten.


Nächste Schritte

Einige der anderen Ressourcen zum Thema Bildung, die Sie interessieren könnten

Egal, ob Sie bereit sind, eine App zu erstellen oder einfach nur mehr darüber erfahren möchten, wir haben alles im Griff.

Oder erfahren Sie mehr über die Verwendung der Office 365-Plattform:

© 2018 Microsoft