Prüfen, ob Ihr SIS die Anforderungen an Google Classroom erfüllt

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/v1p1 endet
• 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 sollen für Konsistenz sorgen und Fehler minimieren, die bei der Verwendung von SIS-Integrationen mit 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.

Wichtig :In den folgenden Tabellen finden Sie einige Hinweise zur Einbindung in Classroom. Anhand der Ergebnisse des Konformitätstests können Sie prüfen, ob die Anforderungen erfüllt sind.

Einfache Notensynchronisierung

Test	Zeiger
Lehrkräfte: GetAllTeachers	Der Endpunkt GET /teachers wird mit dem Abfrageparameter limit 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: GetClassesForTeacher	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. Sie ist optional und wird für die Datenbereinigung verwendet. Der nachfolgende GET /classes/{class_sourced_id}/lineItems-Endpunkt ist ebenfalls optional und prüft, ob die Werbebuchung gelöscht wurde.

Benotungskategorien

Test	Zeiger
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 / Bereinigung)	Der Test „DeleteLineItem“ ist optional und kann zur Datenbereinigung verwendet werden.

Benotungszeiträume

Test	Zeiger
GetGradingPeriodsForTerm	Die Unterstützung von Benotungszeiträumen wird durch Abrufen der term_sourced_id im Test „GetAllClasses with filter“ getestet. Mit dieser term_sourced_id werden die Benotungszeiträume im Semester abgerufen, indem im Test „GetGradingPeriodsForTerm“ der Endpunkt GET terms/{term_sourced_id}/gradingPeriods aufgerufen wird.

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 OneRoster 1.1 erfüllt. Laden Sie den generierten 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 [e-mail].

Support anfordern

Wenn Sie Fragen oder Bedenken haben, senden Sie eine E-Mail an [e-mail].