Google Classroom obsługuje synchronizację dziennika ocen i importowanie list uczniów w przypadku wielu systemów informacji o uczniach zgodnych z OneRoster. Google współpracuje z platformami SIS, które spełniają określone przez Google wymagania OneRoster.
Dzięki współpracy z Classroom administratorzy mogą łączyć zajęcia w Classroom z systemem informacji o uczniach.
Rysunek 1. Gdy systemy informacji o uczniach są zintegrowane z Classroom, administratorzy mogą wybrać system informacji o uczniach z menu.
Ścieżka rozwoju partnera oferującego system informacji o uczniach
Jeśli chcesz nawiązać współpracę z Classroom, wypełnij formularz zgłoszenia zainteresowania.
Zespół Classroom przygotował zestaw testów zgodności, które mogą pomóc zainteresowanym partnerom w zakresie systemów informacji o uczniach w zapoznaniu się z wymaganiami Google. Możesz przeprowadzić testy zgodności, zanim skontaktujesz się z zespołem Classroom, aby sprawdzić, w jakim stopniu Twój produkt spełnia wymagania Google.
Uzyskiwanie domeny demonstracyjnej dewelopera
Aby tworzyć i weryfikować integrację, możesz potrzebować dostępu do aktywnej instancji Google Classroom. Kwalifikujący się testerzy muszą mieć wersję Plus Google Workspace for Education. Jeśli nie masz dostępu do domeny Google Workspace for Education z tymi licencjami jako administrator, wykonaj czynności, aby uzyskać domenę testową dla deweloperów i poprosić o przejście na wyższą wersję domeny demonstracyjnej. W Twojej domenie zostanie udostępnionych 10 licencji na Google Workspace for Education Plus.
Dostęp do testów i ich przeprowadzanie
Aby uruchomić testy, potrzebujesz:
- Adres URL tokena do pobierania danych logowania OAuth 2.0
- Adres URL One Roster kończący się 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 notatnik Jupyter umożliwiają uruchamianie wszystkich testów naraz. Pomoże Ci to wygenerować wyniki testów, które możesz udostępnić zespołowi Google Classroom.
Wymagania dotyczące systemu informacji o uczniach i oczekiwane zachowanie
Testy zdefiniowane przez Google mają na celu umożliwienie zainteresowanym partnerom SIS sprawdzenia, czy ich produkt 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 SIS w Classroom. Zapoznaj się z poniższymi wskazówkami dotyczącymi testów. W 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 jest to wyczerpująca lista testów. Upewnij się, że wszystkie testy udostępnione w GitHubie zostały przeprowadzone.
| Test | Wskaźniki |
|---|---|
| Nauczyciele: GetAllTeachers | Wywoływany jest punkt końcowy GET /teachers z parametrem zapytania limit. W kolejnych testach ten parametr służy do sprawdzenia, czy produkt obsługuje rozmiar strony 10 000. |
| Nauczyciele: GetAllTeachers z filtrem e-maili | Punkt końcowy GET /teachers jest wywoływany z parametrem zapytania filter, który służy do filtrowania na podstawie adresu e-mail nauczyciela. W tym celu zostanie użyty adres e-mail nauczyciela podany w sekcji Dane logowania testó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ływany jest punkt końcowy GET /classes/{class_sourced_id}/students. W odpowiedzi musi zostać zwrócony adres e-mail ucznia. |
| GetGradingPeriodsForTerm | Obsługa okresów oceniania jest testowana za pomocą term_sourced_id. Ten 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. |
| LineItem: Create | Okresy oceniania nie są wymagane w przypadku połączeń z numerem PUT /lineItems/{line_item_sourced_id}. |
| LineItem: Edit | Wywołanie interfejsu API nie powinno zwracać błędu, jeśli tytuł zadania jest długi. Test obejmuje tytuł zadania o długości ponad 100 znaków. |
| Wynik: Edytuj | Wartość parametru score powinna być większa niż wartość parametru resultValueMax, aby odzwierciedlać dodatkowe środki. |
| Wynik: Usuń | Punkt końcowy DELETE /results/{result_sourced_id} jest wymagany. |
| Element zamówienia (opcjonalnie / czyszczenie): usuwanie i pobieranie | Punkt końcowy DELETE /lineItems/{line_item_sourced_id} nie jest wymagany. Jest to opcjonalne pole używane 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ślania, czy Twój produkt spełnia wymagania Google dotyczące korzystania z OneRoster 1.2. Pobierz wygenerowany raport lub zrób jego zrzut ekranu, aby udostępnić go zespołowi Google Classroom.
Uzyskaj pomoc
Jeśli masz pytania, wyślij e-maila na adres classroom-sis-external@google.com.