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

Lehrer-REST-API-Referenz

Betrifft: Office 365 Education

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

Office 365 Education-APIs helfen bei der Auswahl von Daten Ihres Office 365-Mandanten, die von Microsoft School Data Sync mit der Cloud synchronisiert wurden. Diese Ergebnisse stellen Informationen über Schulen, Bereiche, Lehrer, Schüler und Dienstpläne zur Verfügung. Die Lehrer-REST-API ermöglicht den Zugriff auf Lehrkräfte in Office 365 Education.

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

Um von Ihrer Anwendung aus auf die Lehrer-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-Mandantendaten an, wählen Sie "Beta" als Version, kopieren und fügen Sie die URLs ein und überprüfen Sie die Antwort.

Alle Lehrer-REST API-Operationen

Die Lehrer sind im Azure Active Directory als Benutzer vertreten. Sie können die Attribute des aktuellen Lehrers, der angemeldet ist, sowie die Schule und die Sektionen, in denen der Lehrer Mitglied ist, abrufen.

Aktuellen Benutzer abrufen | Schule eines Lehrers abrufen | Bereich eines Lehrers abrufen

Verwenden der Lehrer-REST-API

Um mit der Lehrer-REST-API zu interagieren, senden Sie HTTP-GET-Anforderungen.

Wenn der angemeldete Benutzer ein Lehrer ist, verwenden alle REST-API-Anfragen des Lehrers die folgende Root-URL:

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

Lehrer werden im Azure Active Directory als Benutzer dargestellt. Erweiterungsattribute zu den Benutzern fügen lehrerspezifische Informationen hinzu.
Beispielsweise enthält das Attribut extension_fe2174665583431c953114ff7268b7b3_Education_TeacherNumber die Lehrernummer des Lehrers.

Lehrer-Attribute

Die Beschreibung der Attribute, die bei der Identifizierung der Informationen über den Lehrer helfen, finden Sie hier: Lehrer-Attribute


Aktuellen Benutzer abrufen

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

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

Antworttyp

Aktuell eingeloggter Benutzer.

Prüfen Sie, ob der Lehrer

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 Lehrer ist. Suchen Sie das Attribut Education_ObjectType, das gleich ist mit Teacher.

extension_fe2174665583431c953114ff7268b7b3_Education_ObjectType == 'Teacher'

Rufen Sie die Schule eines Lehrers ab

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 Lehrers erhalten, indem Sie die Mitgliedschaft dieses Lehrers ermitteln und dann einen Filter setzen auf extension_fe2174665583431c953114ff7268b7b3_Education_ObjectType == 'School' und objectType == 'AdministrativeUnit'

Lehrer-Mitgliedschaft abrufen

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

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

Antworttyp

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

Filter für die Schule

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


Bereich eines Lehrers abrufen

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.

Lehrer-Mitgliedschaft abrufen

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

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

Antworttyp

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

Filter für Bereich

Sie können den Bereich eines Lehrers 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