Google Classroom obsługuje synchronizację dziennika ocen i importowanie list uczniów w przypadku wielu systemów informacji o uczniach zgodnych ze standardem OneRoster. Współpracujemy z platformami SIS, które spełniają określone przez nas wymagania OneRoster.
Dzięki współpracy z Classroom administratorzy mogą łączyć zajęcia w Classroom z Twoim systemem SIS.
Rysunek 1. Gdy systemy informacji o uczniach (SIS) współpracują z Classroom, administratorzy mogą wybrać system SIS z menu.
Proces rozwoju partnera SIS
Jeśli chcesz nawiązać współpracę z Classroom, wypełnij formularz zainteresowania.
Zespół Classroom utworzył zestaw testów zgodności, które zainteresowani partnerzy SIS mogą wykorzystać, aby zapoznać się z wymaganiami Google'a. 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.
Uzyskanie domeny demonstracyjnej dla deweloperów
Aby tworzyć i weryfikować integrację, możesz potrzebować dostępu do aktywnej instancji Google Classroom. Kwalifikujący się użytkownicy testowi muszą mieć wersję Google Workspace for Education Plus. Jeśli nie masz dostępu administratora do domeny Google Workspace for Education z tymi licencjami, wykonaj te czynności, aby uzyskać domenę testową dla deweloperów i poprosić o przejście na wersję demonstracyjną. Twoja domena zostanie wyposażona w 10 licencji Google Workspace for Education Plus.
Dostęp do testów i ich przeprowadzanie
Aby przeprowadzić testy, potrzebujesz:
- adresu URL tokena do pobierania danych uwierzytelniających OAuth 2.0,
- adresu URL OneRoster kończącego się na
/ims/oneroster/v1p2, - identyfikatora klienta,
- tajnego klucza klienta,
- adresu e-mail nauczyciela.
Testy możesz przeprowadzić za pomocą Google Colab lub notatnika Jupyter. Zarówno Colab, jak i notatnik Jupyter umożliwiają uruchomienie wszystkich testów naraz. Pomaga to wygenerować wyniki testów, które możesz udostępnić zespołowi Google Classroom.
Wymagania SIS 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 tymi wskazówkami dotyczącymi testów. W GitHubie każdy test ma tytuł, do którego odwołują się wskazówki. Pamiętaj, że wskazówki mogą pomóc w wyjaśnieniu wątpliwości, ale nie są pełną listą testów. Upewnij się, że przeprowadzono wszystkie testy dostępne w GitHubie.
| Test | Wskazówki |
|---|---|
| Teachers: GetAllTeachers | Punkt końcowy GET /teachers jest wywoływany z parametrem zapytania limit. W kolejnych testach ten parametr służy do sprawdzenia, czy Twój produkt obsługuje rozmiar strony wynoszący 10 000. |
| Teachers: GetAllTeachers with email filter | Punkt końcowy GET /teachers jest wywoływany z parametrem zapytania filter służącym do filtrowania na podstawie adresu e-mail nauczyciela. Użyje on adresu e-mail nauczyciela podanego w sekcji Credentials (Dane uwierzytelniające) w testach. |
| Classes: GetClassesForTeacher | Punkt końcowy /teachers/{teacher_sourced_id}/classes jest wywoływany z parametrem zapytania filter służącym do filtrowania na podstawie aktywnych zajęć. |
| Students: 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ą parametru 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 | Podczas wywoływania punktu końcowego PUT /lineItems/{line_item_sourced_id} okresy oceniania nie są wymagane. |
| LineItem: Edit | Jeśli tytuł zadania jest długi, wywołanie interfejsu API nie powinno zwracać błędu. Test obejmuje tytuł zadania o długości ponad 100 znaków. |
| Result: Edit | Aby oznaczyć dodatkowe punkty, należy ustawić wartość score większą niż resultValueMax. |
| Result: Delete | Wymagany jest punkt końcowy DELETE /results/{result_sourced_id}. |
| LineItem (Optional / Cleanup): Delete and Get | 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 również opcjonalny i sprawdza, czy element wiersza został usunięty. |
Udostępnianie wyników testów zespołowi Google Classroom
Po przeprowadzeniu testów generowany jest pełny raport z wynikami każdego testu. Te testy służą do sprawdzenia, 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 osobom kontaktowym w zespole Google Classroom.