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 anfordern
Möglicherweise benötigen Sie Zugriff auf eine aktive Google Classroom-Instanz, um eine Integration 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-Integrationen 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. Führen Sie alle in GitHub bereitgestellten Tests aus.
| Test | Hinweise |
|---|---|
| Lehrkräfte: GetAllTeachers | Der Endpunkt GET /teachers wird mit einem Abfrageparameter limit aufgerufen. In nachfolgenden Tests wird dieser Parameter verwendet, um sicherzustellen,dass 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 der 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 oder Studenten muss in der Antwort zurückgegeben werden. |
| GetGradingPeriodsForTerm | Die Unterstützung von Bewertungszeiträumen wird mit 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 | Beim Aufrufen von PUT /lineItems/{line_item_sourced_id} sind keine Bewertungszeiträume erforderlich. |
| LineItem: Bearbeiten | Der API-Aufruf sollte keinen Fehler zurückgeben, wenn ein langer Titel für eine Aufgabe enthalten ist. Der Test enthält einen Titel für eine Aufgabe mit mehr als 100 Zeichen. |
| Ergebnis: Bearbeiten | Es sollte möglich sein, 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 dem Google Classroom-Team zu teilen.
Support anfordern
Wenn Sie Fragen haben, senden Sie eine E-Mail an classroom-sis-external@google.com.