Sprawdzanie, czy system informacji o uczniach spełnia wymagania Google Classroom

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.

  1. Uwagi na temat sekcji Podstawowa synchronizacja ocen:

    • W teście GetAllTeachers punkt końcowy GET /teachers jest wywoływany z parametrem zapytania limit=. 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ńcowy GET /teachers jest wywoływany z parametrem zapytania filter= 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 zapytania filter= służącym do filtrowania na podstawie aktywnych klas.

    • W teście GetStudentsForClass wywoływany jest punkt końcowy GET /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 funkcji PUT /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ście DeleteResult.

    • Punkt końcowy DELETE /lineItems/{line_item_sourced_id} nie jest wymagany. Jest opcjonalny i służy do czyszczenia danych.

  2. 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 testu GetAllClasses 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ńcowego GET terms/{term_sourced_id}/gradingPeriods?limit=10000 w teście GetGradingPeriodsForTerm.

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.