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 są dostępne w GitHub. 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,
Zestaw testów zawiera 3 sekcje:
- Podstawowa synchronizacja ocen
- Kategorie ocen
- Okresy oceniania
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 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 za pomocą parametru zapytania filter, który służy do filtrowania na podstawie 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. |
| Element zamówienia: utwórz | Podczas wywoływania funkcji PUT /lineItems/{line_item_sourced_id} nie trzeba podawać kategorii oceniania ani okresów oceniania. |
| 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. |
Kategorie ocen
| Test | Wskaźniki |
|---|---|
| GetAllCategories lub GetCategoriesForClass | Wymagana jest tylko 1 funkcja GET /categories: GetAllCategories lub GetCategoriesForClass. Jeśli chcesz uruchomić wszystkie testy naraz, wyłącz ten, którego nie używasz. |
| DeleteLineItem (opcjonalnie / czyszczenie) | Test DeleteLineItem jest opcjonalny i może służyć 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 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. 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.