Partnerzy systemu SIS, którzy są zainteresowani, mogą skorzystać z testów zgodności na GitHubie, aby sprawdzić, czy ich produkt spełnia wymagania dotyczące korzystania z OneRoster w Google Classroom.
Dostęp do testów i ich przeprowadzanie
Aby przeprowadzić testy, musisz mieć:
- Adres URL tokena do pobierania danych uwierzytelniających OAuth 2.0
- Adres URL One Roster zakończony na
/ims/oneroster/v1p1 - Identyfikator klienta
- Tajny klucz klienta
- adres e-mail nauczyciela,
Testy możesz uruchomić za pomocą Google Colab lub notatnika Jupyter. Zarówno Colab, jak i notatniki Jupyter umożliwiają uruchamianie wszystkich testów jednocześnie. Dzięki temu możesz wygenerować wyniki testu i udostępnić je zespołowi Google Classroom.
Wymagania dotyczące systemu SIS i oczekiwane działanie
Testy zdefiniowane przez Google mają umożliwić zainteresowanym partnerom systemu SIS sprawdzenie, czy ich usługa spełnia wymagania Google dotyczące korzystania z OneRoster, oraz zminimalizowanie błędów, które mogą wystąpić u użytkowników podczas korzystania z integracji z systemem SIS w Classroom. Zapoznaj się z podpowiedziami dotyczącymi testów. Na GitHubie 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 stanowią wyczerpującej listy testów. Upewnij się, że uruchomiono wszystkie testy dostępne w GitHub.
| 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 za pomocą parametru zapytania filter, który służy do filtrowania według adresu e-mail nauczyciela. Użyjemy adresu e-mail nauczyciela podanego w sekcji danych logowania. |
| 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 | Wywołujemy punkt końcowy GET /classes/{class_sourced_id}/students. Adres e-mail ucznia musi zostać zwrócony w odpowiedzi. |
| GetGradingPeriodsForTerm | Obsługa okresów oceniania jest testowana za pomocą term_sourced_id. 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. |
| Element zamówienia: utwórz | Okresy oceniania nie są wymagane podczas wywoływania funkcji PUT /lineItems/{line_item_sourced_id}. |
| Element zamówienia: edytowanie | 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 jest też opcjonalny i sprawdza, czy element zamówienia został usunięty. |
Udostępnianie wyników testu zespołowi Google Classroom
Po przeprowadzeniu testów generowany jest pełny raport z wynikami każdego z nich. Te testy służą do określenia, czy Twój produkt spełnia wymagania Google dotyczące konsumpcji OneRoster 1.1. Pobierz lub zrób zrzut ekranu wygenerowanego raportu, aby udostępnić go zespołowi Google Classroom.
Uzyskaj pomoc
Jeśli masz pytania lub wątpliwości, wyślij e-maila na adres classroom-sis-external@google.com.