Google Classroom obsługuje synchronizację dziennika ocen i import listy uczniów w przypadku kilku systemów informacji o uczniach (SIS) zgodnych ze standardem OneRoster. Google współpracuje z platformami SIS, które spełniają wymagania OneRoster określone przez Google.
Dzięki współpracy z Classroom administratorzy mogą łączyć zajęcia w Classroom z systemem informacji o uczniach.
Rysunek 1. Jeśli systemy informacji o uczniach są zintegrowane z Classroom, administratorzy mogą wybrać system informacji o uczniach w menu.
Proces rozwoju partnera oferującego system informacji o uczniach
Jeśli chcesz nawiązać współpracę z Classroom, napisz na adres classroom-sis-external@google.com, aby dowiedzieć się więcej.
Zespół Classroom opracował zestaw testów zgodności, które zainteresowani partnerzy systemów informacji o uczniach mogą wykorzystać do zapoznania się z wymaganiami Google. Możesz przeprowadzić testy zgodności, zanim skontaktujesz się z zespołem Classroom, aby sprawdzić, na ile Twój produkt spełnia wymagania Google.
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 naraz. 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 dotyczące korzystania z OneRoster, oraz zminimalizowanie liczby błędów, które mogą wystąpić podczas korzystania z integracji z systemem SIS w Classroom. Zapoznaj się z tymi wskazówkami 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-maili | 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 „Dane logowania” podczas egzaminów. |
| Klasy: GetClassesForTeacher | Punkt końcowy /teachers/{teacher_sourced_id}/classes jest wywoływany z parametrem 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. |
| LineItem (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.2. 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.