OneRoster für Schüler-/Studenteninformationssysteme

Google Classroom unterstützt die Synchronisierung des Notenbuchs und den Import von Teilnehmerlisten für eine Reihe von OneRoster-kompatiblen Schüler-/Studenteninformationssystemen (SIS). Google arbeitet mit SIS-Plattformen zusammen, die die von Google festgelegten OneRoster-Anforderungen erfüllen.

Durch die Zusammenarbeit 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 in der Drop-down-Liste auswählen.

Entwicklung von SIS-Partnern

Wenn Sie an einer Partnerschaft mit Classroom interessiert sind, füllen Sie das Antragsformular 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 durchzuführen, bevor Sie sich an das Classroom-Team wenden, um zu ermitteln, wie genau Ihr Produkt den Anforderungen von Google entspricht.

Demo-Domain für Entwickler erhalten

Möglicherweise benötigen Sie Zugriff auf eine aktive Google Classroom-Instanz, um eine Integration zu entwickeln und zu validieren. Berechtigte Testnutzer benötigen die Plus-Version von Google Workspace for Education. Wenn Sie keinen Administratorzugriff auf eine Google Workspace for Education-Domain mit diesen Lizenzen haben, erstellen Sie eine Entwicklertestdomain und beantragen Sie ein Upgrade der Demodomäne. Ihrer Domain werden 10 Google Workspace for Education Plus-Lizenzen zugewiesen.

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/v1p1 endet
  • Client-ID
  • Clientschlüssel
  • Die E‑Mail-Adresse einer Lehrkraft

Sie können die Tests mit Google Colab oder Jupyter-Notebook ausführen. Sowohl in Colab als auch in Jupyter Notebook können Sie alle Tests gleichzeitig ausführen. So können Sie die Testergebnisse generieren, die Sie mit dem Google Classroom-Team teilen können.

SIS-Anforderungen und erwartetes Verhalten

Die von Google definierten Tests sollen interessierten SIS-Partnern die Möglichkeit geben, festzustellen, ob ihr Produkt die Anforderungen von Google für die OneRoster-Nutzung erfüllt, und Fehler zu minimieren, die Nutzer 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 Pointern verwiesen wird. Die Hinweise können helfen, Fragen zu klären, aber sie sind keine vollständige Liste der Tests. Achten Sie darauf, dass Sie alle auf GitHub bereitgestellten Tests ausgeführt haben.

Test Hinweise
Lehrkräfte: GetAllTeachers Der Endpunkt GET /teachers wird mit dem 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 GET /teachers-Endpunkt wird mit dem Abfrageparameter filter aufgerufen, um nach der E-Mail-Adresse eines Lehrers zu filtern. Dabei wird die E‑Mail-Adresse des Lehrers verwendet, die Sie im Abschnitt „Anmeldedaten“ der Tests angegeben haben.
Klassen: GetClassesForTeacher Der /teachers/{teacher_sourced_id}/classes-Endpunkt wird mit dem Abfrageparameter filter aufgerufen, 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 Benotungszeiträumen wird mit term_sourced_id getestet. Mit diesem term_sourced_id werden die Benotungszeiträume im Kurs abgerufen, indem der GET terms/{term_sourced_id}/gradingPeriods-Endpunkt aufgerufen wird.
LineItem: Create Benotungszeiträ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 die Aufgabe angegeben wird. Der Test enthält einen Titel für die Aufgabe mit mehr als 100 Zeichen.
Ergebnis: Bearbeiten Es sollte möglich sein, score auf einen Wert festzulegen, der größer als resultValueMax ist, um zusätzliches Guthaben darzustellen.
Ergebnis: Löschen Der DELETE /results/{result_sourced_id}-Endpunkt ist erforderlich.
LineItem (Optional / Bereinigung): Delete und Get Der DELETE /lineItems/{line_item_sourced_id}-Endpunkt ist nicht erforderlich. Sie ist optional und wird für die Datenbereinigung verwendet. Der nachfolgende GET /classes/{class_sourced_id}/lineItems-Endpunkt ist ebenfalls optional und testet, ob die Werbebuchung 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. Mit diesen Tests wird ermittelt, ob Ihr Produkt die Anforderungen von Google für die Nutzung von OneRoster 1.2 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

Bei Fragen senden Sie bitte eine E‑Mail an classroom-sis-external@google.com.