Aby zintegrować system informacji o uczniach z Classroom, sprawdź, czy Twój produkt spełnia wymagania partnerskie Classroom. Aby to zrobić, uruchom dostarczony zestaw testów zgodności.
Dostęp do testów i ich przeprowadzanie
Testy zgodności znajdziesz w GitHubie. Aby przeprowadzić testy, musisz mieć:
- Adres URL tokena do pobierania danych logowania OAuth 2.0
- URL One Roster kończący się na
/ims/oneroster/v1p1 - Identyfikator klienta
- Tajny klucz klienta
- adres e-mail nauczyciela,
Zestaw testów zawiera 3 sekcje:
- Synchronizowanie ocen w podstawach
- Kategorie ocen
- Okresy oceniania
Testy możesz przeprowadzać za pomocą Google Colab lub notatnika Jupyter. Zarówno notatnik Colab, jak i notatnik Jupyter pozwalają uruchamiać wszystkie testy jednocześnie. Pomoże Ci to wygenerować wyniki testu, aby udostępnić je zespołowi Google Classroom.
Wymagania dotyczące systemu informacji o uczniach i oczekiwane działanie
Testy zdefiniowane przez Google służą do zachowania spójności i zminimalizowania błędów, które mogą wystąpić u użytkowników podczas korzystania z integracji z systemem SIS w Classroom. Zapoznaj się z poniższymi wskazówkami dotyczącymi testów. W GitHub każdy test ma tytuł, do którego odwołują się wskaźniki. Pamiętaj, że wskazówki mogą pomóc w wyjaśnieniu pytań, ale nie jest to wyczerpująca lista testów. Upewnij się, że uruchomiono wszystkie testy dostępne w GitHub.
Podstawowa synchronizacja ocen
| Test | Wskaźniki |
|---|---|
| Nauczyciele: GetAllTeachers | Punkt końcowy GET /teachers jest wywoływany za pomocą parametru zapytania limit. W kolejnych testach ten parametr służy do sprawdzania, czy Twój produkt obsługuje rozmiar strony 10 000. |
| Nauczyciele: GetAllTeachers z filtrem e-mail | Punkt końcowy GET /teachers jest wywoływany z parametrem zapytania filter używanym do filtrowania na podstawie adresu e-mail nauczyciela. Użyje on adresu e-mail nauczyciela podanego w sekcji Dane logowania na egzaminach. |
| Klasy: GetClassesForTeacher | Punkt końcowy /teachers/{teacher_sourced_id}/classes jest wywoływany za pomocą parametru zapytania filter, który służy do filtrowania na podstawie aktywnych klas. |
| Uczniowie: GetStudentsForClass | Punkt końcowy GET /classes/{class_sourced_id}/students jest wywoływany. Adres e-mail ucznia musi zostać zwrócony w odpowiedzi. |
| Element zamówienia: utwórz | Gdy dzwonisz pod numer PUT /lineItems/{line_item_sourced_id}, nie są wymagane kategorie oceniania ani okresy oceniania. |
| Element zamówienia: Edytuj | Wywołanie interfejsu API nie powinno zwracać błędu, jeśli zawiera długi tytuł projektu. Test zawiera tytuł projektu o długości co najmniej 100 znaków. |
| Wynik: edytowanie | Wartość parametru score powinna być większa od wartości parametru resultValueMax, aby reprezentować dodatkowy kredyt. |
| Wynik: usuń | Punkt końcowy DELETE /results/{result_sourced_id} jest wymagany. |
| Element zamówienia (opcjonalnie / Czyszczenie): Usuń i pobierz | Punkt końcowy DELETE /lineItems/{line_item_sourced_id} nie jest wymagany. Jest on opcjonalny i służy do czyszczenia danych. Kolejny punkt końcowy GET /classes/{class_sourced_id}/lineItems również jest opcjonalny i sprawdza, czy element zamówienia został usunięty. |
Kategorie ocen
| Test | Wskaźniki |
|---|---|
| GetAllCategories lub GetCategoriesForClass | Wymagany jest tylko 1 punkt końcowy GET /categories (GetAllKategorie lub GetKategorieForClass). Jeśli przeprowadzasz wszystkie testy jednocześnie, w komentarzu podaj ten, którego nie używasz. |
| DeleteLineItem (opcjonalnie / czyszczenie) | Test DeleteLineItem jest opcjonalny i można go używać do czyszczenia danych. |
Okresy oceniania
| Test | Wskaźniki |
|---|---|
| GetGradingPeriodsForTerm | Obsługa okresów oceniania jest testowana przez pobieranie term_sourced_id w teście GetAllClasses with filter. Ten element term_sourced_id służy do pobierania okresów oceniania w semestrze przez wywołanie punktu końcowego GET terms/{term_sourced_id}/gradingPeriods w teście GetGradingPeriodsForTerm. |
Udostępnianie wyników testu zespołowi Google Classroom
Po zakończeniu testów zostanie wygenerowany pełny raport z wynikami każdego z nich. Te testy służą do określenia, czy dany produkt spełnia wymagania Google OneRoster 1.1. Pobierz lub zrób zrzut ekranu wygenerowanego raportu. Wyślij raport i link do certyfikatu OneRoster 1.1 Twojego produktu na adres classroom-sis-external@google.com.
Uzyskaj pomoc
Jeśli masz pytania lub wątpliwości, wyślij e-maila na adres classroom-sis-external@google.com.