Wenn Sie Ihr SIS mit Classroom verknüpfen möchten, müssen Sie prüfen, ob Ihr Produkt die Partnerschaftsanforderungen von Classroom erfüllt. Führen Sie dazu die bereitgestellten Konformitätstests aus.
Auf die Tests zugreifen und sie ausführen
Sie können auf die Konformitätstests auf GitHub zugreifen. Für die Ausführung der Tests benötigen Sie Folgendes:
- Token-URL zum Abrufen von OAuth 2.0-Anmeldedaten
- OneRoster-URL, die auf
/ims/oneroster/v1p1endet - Client-ID
- Clientschlüssel
- E-Mail-Adresse einer Lehrkraft
Die Testsuite besteht aus drei Abschnitten:
- Einfache Notensynchronisierung
- Benotungskategorien
- Benotungszeiträume
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.
Anforderungen an das Studenteninformationssystem und erwartetes Verhalten
Die von Google definierten Tests dienen dazu, Konsistenz zu wahren und Fehler zu minimieren, 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, aber es ist keine umfassende Liste der Tests. Sie müssen alle in GitHub bereitgestellten Tests ausgeführt haben.
Einfache Notensynchronisierung
| Test | Zeiger |
|---|---|
| Lehrkräfte: GetAllTeachers | Der Endpunkt GET /teachers wird mit einem limit-Abfrageparameter aufgerufen. In nachfolgenden Tests wird mit diesem Parameter sichergestellt, dass Ihr Produkt eine Seitengröße von 10.000 unterstützt. |
| Lehrkräfte: GetAllTeachers mit E-Mail-Filter | Der GET /teachers-Endpunkt wird mit einem filter-Abfrageparameter aufgerufen, der zum Filtern nach der E-Mail-Adresse eines Lehrers verwendet wird. Dazu wird die E-Mail-Adresse des Lehrkräfte verwendet, die Sie im Abschnitt „Anmeldedaten“ der Tests angegeben haben. |
| Kurse: GetKurseForTeacher | Der /teachers/{teacher_sourced_id}/classes-Endpunkt wird mit einem filter-Abfrageparameter aufgerufen, der zum Filtern nach aktiven Klassen verwendet wird. |
| 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. |
| LineItem: Create | Benotungskategorien oder Benotungszeiträume sind beim Aufruf von PUT /lineItems/{line_item_sourced_id} nicht erforderlich. |
| Werbebuchung: Bearbeiten | Der API-Aufruf sollte keinen Fehler zurückgeben, wenn ein langer Titel für die Aufgabe angegeben ist. Der Test enthält einen Aufgabentitel mit mehr als 100 Zeichen. |
| Ergebnis: Bearbeiten | Es sollte möglich sein, score auf einen Wert festzulegen, der über resultValueMax liegt, um zusätzliche Punkte zu vergeben. |
| Ergebnis: Löschen | Der DELETE /results/{result_sourced_id}-Endpunkt ist erforderlich. |
| Werbebuchung (optional / Bereinigen): Löschen und abrufen | Der DELETE /lineItems/{line_item_sourced_id}-Endpunkt ist nicht erforderlich. Er ist optional und wird zur Datenbereinigung verwendet. Der nachfolgende Endpunkt GET /classes/{class_sourced_id}/lineItems ist ebenfalls optional und prüft, ob die Werbebuchung gelöscht wurde. |
Benotungskategorien
| Test | Mauszeiger |
|---|---|
| GetAllCategories oder GetCategoriesForClass | Es ist nur ein GET /categories-Endpunkt erforderlich, entweder GetAllCategories oder GetCategoriesForClass. Wenn Sie alle Tests gleichzeitig ausführen möchten, kommentieren Sie die nicht verwendete Funktion aus. |
| DeleteLineItem (optional / Bereinigen) | Der Test „DeleteLineItem“ ist optional und kann zur Datenbereinigung verwendet werden. |
Benotungszeiträume
| Test | Zeiger |
|---|---|
| GetGradingPeriodsForTerm | Die Unterstützung für Benotungszeiträume wird getestet, indem term_sourced_id aus dem GetAllClass-Test mit Filter abgerufen wird. Mit term_sourced_id werden die Benotungszeiträume im Schuljahr durch Aufrufen des Endpunkts GET terms/{term_sourced_id}/gradingPeriods im GetGradingPeriodsForTerm-Test abgerufen. |
Testergebnisse mit dem Google Classroom-Team teilen
Nach Abschluss der Tests wird ein vollständiger Bericht mit den Ergebnissen jedes Tests generiert. Anhand dieser Tests wird ermittelt, ob Ihr Produkt die Nutzungsanforderungen von Google für OneRoster 1.1 erfüllt. Laden Sie den Bericht herunter oder erstellen Sie einen Screenshot. Senden Sie den Bericht und einen Link zur OneRoster 1.1-Zertifizierung Ihres Produkts per E-Mail an [email protected].
Support kontaktieren
Wenn Sie Fragen oder Bedenken haben, senden Sie eine E-Mail an [email protected].