Google Classroom unterstützt die Notenbuchsynchronisierung und den Import von Teilnehmerlisten für eine Reihe von Schüler-/Studenteninformationssystemen (SIS), die mit OneRoster kompatibel sind. Google arbeitet mit SIS-Plattformen zusammen, die die von Google festgelegten OneRoster-Anforderungen erfüllen.
Durch die Partnerschaft mit Classroom können Administratoren ihre Classroom-Kurse mit ihrem SIS verknüpfen.
Abbildung 1 : Wenn Schüler-/Studenteninformationssysteme (SIS) mit Classroom zusammenarbeiten, können Administratoren das SIS im Drop-down-Menü auswählen.
Entwicklungsprozess für SIS-Partner
Wenn Sie an einer Partnerschaft mit Classroom interessiert sind, füllen Sie das Formular für Interessenten aus.
Das Classroom-Team hat eine Reihe von Konformitätstests erstellt, mit denen sich interessierte SIS-Partner mit den Anforderungen von Google vertraut machen können. Sie haben die Möglichkeit, die Konformitätstests auszuführen, bevor Sie sich an das Classroom-Team wenden, um zu ermitteln, inwieweit Ihr Produkt die Anforderungen von Google erfüllt.
Demo-Domain für Entwickler abrufen
Möglicherweise benötigen Sie Zugriff auf eine aktive Google Classroom-Instanz, um eine Einbindung zu erstellen und zu validieren. Berechtigte Testnutzer benötigen die Plus-Version von Google Workspace for Education. Wenn Sie keinen Administrator zugriff auf eine Google Workspace for Education-Domain mit diesen Lizenzen haben, führen Sie die Schritte aus, um eine Testdomain für Entwickler zu erhalten und ein Upgrade auf eine Demo-Domain anzufordern. Ihre Domain wird mit 10 Google Workspace for Education Plus-Lizenzen bereitgestellt.
Auf die Tests zugreifen und sie ausführen
Für die Ausführung der Tests benötigen Sie Folgendes:
- Token-URL zum Abrufen von OAuth 2.0-Anmeldedaten
- OneRoster-URL, die mit
/ims/oneroster/v1p2endet - Client-ID
- Clientschlüssel
- Eine E-Mail-Adresse einer Lehrkraft
Sie können die Tests mit Google Colab oder Jupyter Notebook ausführen. Mit beiden Tools können Sie alle Tests gleichzeitig ausführen. So können Sie die Testergebnisse generieren, um sie mit dem Google Classroom-Team zu teilen.
SIS-Anforderungen und erwartetes Verhalten
Die von Google definierten Tests sollen interessierten SIS-Partnern helfen, zu ermitteln, ob ihr Produkt die Anforderungen von Google für die OneRoster-Nutzung erfüllt. Außerdem sollen Fehler minimiert werden, die bei der Verwendung von SIS-Einbindungen in Classroom auftreten können. Lesen Sie sich die folgenden Hinweise zu den Tests durch. In GitHub hat jeder Test einen Titel, auf den in den Hinweisen verwiesen wird. Die Hinweise können helfen, Fragen zu klären, sind aber keine umfassende Liste der Tests. Achten Sie darauf, dass Sie alle in GitHub bereitgestellten Tests ausgeführt haben.
| Test | Hinweise |
|---|---|
| Lehrkräfte: GetAllTeachers | Der Endpunkt GET /teachers wird mit einem Abfrageparameter limit aufgerufen. In nachfolgenden Tests wird dieser Parameter verwendet, um zu prüfen,ob Ihr Produkt eine Seitengröße von 10.000 unterstützt. |
| Lehrkräfte: GetAllTeachers mit E-Mail-Filter | Der Endpunkt GET /teachers wird mit einem Abfrageparameter filter aufgerufen, der verwendet wird, um nach einer E-Mail-Adresse einer Lehrkraft zu filtern. Dabei wird die E-Mail-Adresse der Lehrkraft verwendet, die Sie im Abschnitt „Anmeldedaten“ der Tests angegeben haben. |
| Kurse: GetClassesForTeacher | Der Endpunkt /teachers/{teacher_sourced_id}/classes wird mit einem Abfrageparameter filter aufgerufen, der verwendet wird, um nach aktiven Kursen zu filtern. |
| Schüler/Studenten: GetStudentsForClass | Der Endpunkt GET /classes/{class_sourced_id}/students wird aufgerufen. Die E-Mail-Adresse des Schülers/Studenten muss in der Antwort zurückgegeben werden. |
| GetGradingPeriodsForTerm | Die Unterstützung von Bewertungszeiträumen wird mit der term_sourced_id getestet. Diese term_sourced_id wird verwendet, um die Bewertungszeiträume im Zeitraum abzurufen, indem der GET terms/{term_sourced_id}/gradingPeriods Endpunkt aufgerufen wird. |
| LineItem: Erstellen | Bewertungszeiträume sind beim Aufrufen von PUT /lineItems/{line_item_sourced_id} nicht erforderlich. |
| LineItem: Bearbeiten | Der API-Aufruf sollte keinen Fehler zurückgeben, wenn ein langer Titel für eine Aufgabe angegeben wird. Der Test enthält einen Titel für eine Aufgabe mit mehr als 100 Zeichen. |
| Ergebnis: Bearbeiten | Es sollte möglich sein, den score auf einen Wert über resultValueMax festzulegen, um zusätzliche Punkte darzustellen. |
| Ergebnis: Löschen | Der Endpunkt DELETE /results/{result_sourced_id} ist erforderlich. |
| LineItem (optional / Bereinigung): Löschen und abrufen | Der Endpunkt DELETE /lineItems/{line_item_sourced_id} ist nicht erforderlich. Er ist optional und wird für die Datenbereinigung verwendet. Der nachfolgende Endpunkt GET /classes/{class_sourced_id}/lineItems ist ebenfalls optional und testet, ob das LineItem gelöscht wurde. |
Testergebnisse mit dem Google Classroom-Team teilen
Nachdem Sie die Tests ausgeführt haben, wird ein vollständiger Bericht mit den Ergebnissen der einzelnen Tests generiert. Anhand dieser Tests wird ermittelt, ob Ihr Produkt die Anforderungen von Google für die OneRoster 1.2-Nutzung erfüllt. Laden Sie den generierten Bericht herunter oder machen Sie einen Screenshot davon, um ihn mit Ihren Kontakten im Google Classroom-Team zu teilen.