Google Classroom obsługuje importowanie list uczniów i synchronizowanie dziennika ocen w przypadku wielu systemów informacji o uczniach zgodnych ze standardem OneRoster. Google współpracuje z platformami systemów informacji o uczniach, które spełniają wymagania OneRoster określone przez Google.
Rysunek 1. Gdy system informacji o uczniach (SIS) jest zintegrowany z Classroom, administratorzy mogą wybrać go w menu.
Wprowadzenie partnera oferującego system informacji o uczniach
Poniżej znajdziesz krótkie omówienie procesu wprowadzania partnera systemu informacji o uczniach:
Wyrażenie zainteresowania: jeśli chcesz nawiązać współpracę z Classroom, wypełnij formularz zgłoszenia zainteresowania.
Zapoznaj się z testami zgodności i przeprowadź je: aby dowiedzieć się, czy Twój system informacji o uczniach jest gotowy do integracji z Classroom, możesz zapoznać się z testami zgodności i wymaganiami Google. Możesz przeprowadzić testy zgodności, zanim wyrazisz zainteresowanie zespołowi Google Classroom, aby określić, w jakim stopniu Twój produkt spełnia wymagania Google.
Skontaktuj się z zespołem Google Classroom: zespół Classroom skontaktuje się z Tobą po przesłaniu formularza zgłoszenia zainteresowania, jeśli będzie możliwość nawiązania współpracy.
Udostępnij wyniki testów i utwórz kompleksową integrację: gdy zespół Classroom się z Tobą skontaktuje, udostępnij wyniki testów zgodności. Twój zespół będzie współpracować z Google, aby zweryfikować i dokończyć integrację.
Testy zgodności
Zdefiniowane przez Google testy zgodności umożliwiają partnerom systemów informacji o uczniach określenie, czy ich produkt spełnia wymagania Google dotyczące korzystania z OneRoster, oraz zminimalizowanie błędów, które mogą wystąpić podczas korzystania z integracji systemów informacji o uczniach w Classroom. Testy są publikowane na GitHubie.
Uzyskiwanie dostępu do testów i ich przeprowadzanie
Aby przeprowadzić testy, potrzebujesz:
- Adres URL tokena do pobierania danych uwierzytelniających OAuth 2.0
- Adres URL One Roster kończący się na
/ims/oneroster/v1p2 - Identyfikator klienta
- Tajny klucz klienta
- adres 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. Pomoże Ci to wygenerować wyniki testu, które możesz udostępnić zespołowi Google Classroom.
Wymagania i oczekiwane działanie
Przeczytaj poniższe wskazówki dotyczące testów. W GitHubie każdy test ma tytuł, do którego odwołuje się tabela. Te wskazówki mogą pomóc w wyjaśnieniu wątpliwości, ale nie jest to wyczerpująca lista testów. Upewnij się, że wszystkie testy dostępne na GitHubie zostały uruchomione, aby zapewnić zgodność.
| Test | Wskaźniki |
|---|---|
| Nauczyciele: GetAllTeachers | Punkt końcowy GET /teachers jest wywoływany z parametrem zapytania limit. W kolejnych testach ten parametr służy do sprawdzania, czy usługa obsługuje rozmiar strony wynoszący 10 000. |
| Nauczyciele: GetAllTeachers z filtrem adresu e-mail | 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. Użyjemy adresu e-mail nauczyciela podanego w sekcji Dane logowania w testach. |
| Classes: 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 zajęć. |
| Uczniowie: GetStudentsForClass | Wywoływany jest 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 parametr 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 podczas wywoływania metody PUT /lineItems/{line_item_sourced_id}. |
| Element zamówienia: edytuj | Wywołanie interfejsu API nie powinno zwracać błędu, jeśli zawiera długi tytuł projektu. Test obejmuje tytuł projektu o długości co najmniej 100 znaków. |
| Wynik: edytuj | Powinno być możliwe ustawienie wartości score na większą niż resultValueMax, aby odzwierciedlić dodatkowe punkty. |
| Wynik: usunięcie. | Punkt końcowy DELETE /results/{result_sourced_id} jest wymagany. |
| LineItem (opcjonalnie / czyszczenie): Delete i Get | Punkt końcowy DELETE /lineItems/{line_item_sourced_id} nie jest wymagany. Jest opcjonalny i służy do czyszczenia danych. Kolejny punkt końcowy GET /classes/{class_sourced_id}/lineItems również jest 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. Wyniki służą do określenia, czy usługa spełnia wymagania Google dotyczące korzystania z OneRoster 1.2. Pobierz wygenerowany raport lub zrób jego zrzut ekranu, aby udostępnić go kontaktom w zespole Google Classroom.
Uzyskiwanie domeny demonstracyjnej dla deweloperów
Gdy zespół Google Classroom sprawdzi wyniki testu zgodności, domena demonstracyjna dla deweloperów pozwoli Ci zweryfikować pełną integrację. Pamiętaj, że pomyślne przejście testów zgodności nie gwarantuje zatwierdzenia partnerstwa ani integracji.
Domena demonstracyjna dla deweloperów to działające, testowe środowisko Google Classroom, które pomaga sprawdzić, czy integracja działa zgodnie z oczekiwaniami. Wykonaj czynności, aby uzyskać domenę demonstracyjną dla deweloperów i poprosić o uaktualnienie domeny demonstracyjnej. Opcja ta zapewnia Twojej domenie 10 licencji na Google Workspace for Education Plus. Te licencje muszą być przypisane do użytkowników testowych w domenie dewelopera, aby mogli oni testować funkcje integracji z systemem informacji o uczniach w Classroom.
Najczęstsze pytania
1. Jakiego modelu danych Classroom oczekuje od systemu informacji o uczniach?
Classroom jest zgodny ze specyfikacją OneRoster 1.2. Jeśli Twój system informacji o uczniach używa innej struktury danych, możesz napotkać nieoczekiwane problemy. Jeśli na przykład Twój system obsługuje zagnieżdżone relacje między okresami oceniania a kategoriami ocen, wykracza to poza specyfikację OneRoster 1.2. W takim przypadku należy dokładnie przetestować integrację, aby zapewnić prawidłową zgodność.
2. Które oceny i stany projektów są eksportowane do systemu informacji o uczniach?
Do systemu informacji o uczniach są eksportowane tylko zwrócone oceny lub zadania oznaczone jako „nieoddane” lub „zwolniono”. Oceny robocze nie są eksportowane.
3. Co się stanie z elementem zamówienia w systemie informacji o uczniach, jeśli projekt zostanie usunięty w Classroom?
Usunięcie projektu w Classroom nie powoduje usunięcia odpowiadającego mu elementu zamówienia w systemie informacji o uczniach. Zapobiega to przypadkowej utracie danych i niezamierzonym usunięciom kaskadowym.