Aby zintegrować system informacji o uczniach z Classroom, sprawdź, czy Twoja usługa spełnia wymagania dotyczące współpracy z Classroom, przeprowadzając udostępniony zestaw testów zgodności.
Dostęp do testów i ich uruchamianie
Testy zgodności są dostępne na GitHubie. Aby przeprowadzić testy, potrzebne są:
- Adres URL tokena do pobierania danych logowania OAuth 2.0
- Jeden adres URL listy z końcówką
/ims/oneroster/v1p1
- Identyfikator klienta
- Tajny klucz klienta
- adres e-mail nauczyciela,
Pakiet testów obejmuje 3 sekcje:
- Podstawowa synchronizacja ocen
- Kategorie ocen
- Okresy oceniania
Testy możesz uruchomić w Google Colab lub notatniku Jupyter. Zarówno notatnik Colab, jak i Jupyter umożliwiają przeprowadzanie wszystkich testów jednocześnie. Ułatwia to generowanie wyników testu do udostępnienia zespołowi Google Classroom.
Wymagania systemu informacji o uczniach i oczekiwane działanie
Testy zdefiniowane przez Google mają na celu utrzymanie spójności i zminimalizowanie liczby błędów, które użytkownicy mogą napotkać podczas korzystania z integracji z systemem informacji o uczniach z Classroom. Przeczytaj poniższe wskazówki dotyczące testów. W GitHubie każdy test jest oznaczony symbolem @title
. Tytuły są wymienione w wskaźnikach.
Uwagi na temat sekcji Podstawowa synchronizacja ocen:
W teście
GetAllTeachers
punkt końcowyGET /teachers
jest wywoływany z parametrem zapytanialimit=
. W kolejnych testach parametr ten jest używany do sprawdzania, czy produkt obsługuje strony o rozmiarze 10 tys.W teście
GetAllTeachers with email filter
punkt końcowyGET /teachers
jest wywoływany z parametrem zapytaniafilter=
służącym do filtrowania na podstawie adresu e-mail nauczyciela. Przed uruchomieniem testów musisz podać adres e-mail nauczyciela.W teście
GetClassesForTeacher
punkt końcowy/teachers/{teacher_sourced_id}/classes
jest wywoływany z parametrem zapytaniafilter=
służącym do filtrowania na podstawie aktywnych klas.W teście
GetStudentsForClass
wywoływany jest punkt końcowyGET /classes/{class_sourced_id}/students?limit=10000
. W odpowiedzi należy zwrócić adres e-mail ucznia.W teście
PutLineItem Create
kategorie ocen ani okresy oceniania nie są wymagane podczas wywoływania funkcjiPUT /lineItems/{line_item_sourced_id}
.W teście
PutLineItem Edit
wywołanie interfejsu API nie powinno zwracać błędu, jeśli podany jest długi tytuł przypisania. Test zawiera tytuł projektu o długości ponad 100 znaków.W teście
PutResult Edit
możesz ustawićscore
na wartość większą niżresultValueMax
, aby reprezentować dodatkowy udział.Punkt końcowy
DELETE /results/{result_sourced_id}
jest wymagany i przetestowany w teścieDeleteResult
.Punkt końcowy
DELETE /lineItems/{line_item_sourced_id}
nie jest wymagany. Jest opcjonalny i służy do czyszczenia danych.
Uwaga na temat sekcji Kategorie ocen i Okresy oceniania:
- Wymagany jest tylko 1 punkt końcowy
GET /categories
. Jeśli uruchamiasz wszystkie testy zgodności jednocześnie, skomentuj ten, którego nie używasz:/categories?limit=10000
/classes/{class_sourced_id}/categories?limit=10000
- Obsługa okresów oceniania jest sprawdzana, pobierając właściwość
term_sourced_id
z testuGetAllClasses w/ filter
. Ta właściwośćterm_sourced_id
służy do pobierania okresów oceniania w ramach semestru przez wywołanie punktu końcowegoGET terms/{term_sourced_id}/gradingPeriods?limit=10000
w teścieGetGradingPeriodsForTerm
.
- Wymagany jest tylko 1 punkt końcowy
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 wygenerowany raport lub zrób zrzut ekranu. Prześlij raport e-mailem i link do certyfikatu OneRoster 1.1 z Twojej usługi na adres classroom-sis-external@google.com.
Uzyskaj pomoc
W razie pytań lub wątpliwości wyślij e-maila na adres classroom-sis-external@google.com.