Interessierte SIS-Partner können mithilfe der Konformitätstests auf GitHub feststellen, ob ihr Produkt die Anforderungen an die OneRoster-Nutzung in Google Classroom erfüllt.
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 auf
/ims/oneroster/v1p1endet - Client-ID
- Clientschlüssel
- 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.
Anforderungen an das Studenteninformationssystem und erwartetes Verhalten
Die von Google definierten Tests sollen interessierten SIS-Partnern die Möglichkeit geben, zu prüfen, ob ihr Produkt die Anforderungen von Google an die Nutzung von OneRoster erfüllt, 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. Führen Sie alle in GitHub bereitgestellten Tests aus.
| Test | Zeiger |
|---|---|
| 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 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 GET /classes/{class_sourced_id}/students-Endpunkt 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 der term_sourced_id getestet. Mit diesem term_sourced_id werden die Benotungszeiträume im Semester 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. |
| 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. |
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 generierten Bericht herunter oder machen Sie einen Screenshot davon, um ihn mit dem Google Classroom-Team zu teilen.
Support anfordern
Wenn Sie Fragen oder Bedenken haben, senden Sie eine E-Mail an classroom-sis-external@google.com.