Interfejs Google Classroom API udostępnia interfejs programowania dla programistów, administratorów i dyrektorów szkół, który umożliwia zarządzanie zasobami Google Classroom. Możesz tworzyć oprogramowanie, które tworzy, pobiera i modyfikuje kursy w Classroom oraz ich zawartość.
Oto kilka typowych przypadków użycia:
- Zarządzanie kursami, listami uczniów i opiekunami
- Dodawanie projektów, ogłoszeń i materiałów do nauki
- Wystawianie ocen i modyfikowanie ustawień oceniania
- Generowanie danych do analizy
- Umożliwianie znajdowania i korzystania z treści lub narzędzi zewnętrznego dostawcy w Classroom
Czy interfejs Classroom API jest dla mnie odpowiednim rozwiązaniem?
Google udostępnia kilka usług, które ułatwiają korzystanie z Classroom. Poniżej znajdziesz kilka typowych scenariuszy i rekomendacji dotyczących produktów, które mogą najlepiej spełniać Twoje potrzeby.
Modyfikowanie zasobów Google Classroom
| Scenariusz | Zalecane rozwiązania |
|---|---|
| Chcę regularnie zarządzać dużą liczbą kursów, użytkowników lub innych zasobów Classroom. Potrafię pisać kod i utrzymywać infrastrukturę oprogramowania. | Tworzenie aplikacji korzystających z interfejsu Classroom API. |
| Chcę od czasu do czasu zarządzać niewielką liczbą zasobów Classroom. Potrafię pisać niewielkie ilości kodu przy niewielkim nakładzie pracy. | Używaj interfejsu Classroom API z Google Apps Script. |
| Chcę od czasu do czasu wprowadzać zmiany w poszczególnych zasobach Classroom. Znam polecenia terminala. | Użyj Google Apps Manager. |
| Chcę uzyskać dużą liczbę raportów ze szczegółowymi informacjami o wydarzeniach w Classroom. | Korzystaj z BigQuery Data Transfer Service. |
| Chcę przeprowadzić analizę aktywności użytkowników. | Generuj raporty w konsoli administracyjnej lub korzystaj z interfejsu Reports API. |
Integracja z Google Classroom
| Scenariusz | Zalecane rozwiązania |
|---|---|
| Chcę, aby nauczyciele i uczniowie mogli wyświetlać i uruchamiać moje treści w Classroom. | Utwórz dodatek do Classroom. |
| Chcę, aby nauczyciele mogli kliknąć przycisk w mojej witrynie lub aplikacji, który osadzi moje treści w Classroom. | Tworzenie dodatku do Classroom i załączników za pomocą kodu. |
| Chcę, aby nauczyciele mogli klikać przycisk w mojej witrynie lub aplikacji, aby połączyć się z moimi treściami w Classroom. | Tworzenie materiałów do zajęć za pomocą interfejsu Classroom API lub osadzanie przycisków Udostępnij w Classroom. |
| Chcę, aby nauczyciele korzystający z Classroom synchronizowali lub importowali informacje z systemu informacji o uczniach. | Wdróż OneRoster dla systemu informacji o uczniach lub twórz zasoby i uzyskuj do nich dostęp za pomocą interfejsu Classroom API. |
Pierwsze kroki
Zanim rozpoczniesz nowy projekt, wykonaj te czynności:
- Zapoznaj się z naszym przewodnikiem po strukturze interfejsu Classroom API.
- Dowiedz się więcej o poziomach, typach użytkowników, wymaganiach dotyczących użytkowników i działaniach administratora. Te przewodniki wyjaśniają pojęcia związane z Google Classroom i interfejsem Classroom API.
- Dowiedz się, jak działają żądania interfejsu Classroom API.
Zanim zaczniesz tworzyć aplikację, wykonaj wymagane czynności. Wybierz odpowiednie zakresy interfejsu Classroom API, a następnie skonfiguruj środowisko i zacznij wysyłać żądania, korzystając z jednego z przewodników Szybki start:
Eksperymentowanie z narzędziem Google APIs Explorer
Aby wypróbować wywoływanie metod na danych na żywo, użyj Google APIs Explorer. Aby zacząć, nie musisz pisać żadnego kodu, ale pamiętaj, że działania wykonywane za pomocą Eksploratora interfejsów API mogą modyfikować istniejące dane.
Jednym ze sposobów na rozpoczęcie wywoływania metod jest wywołanie metody courses.list(). Ta metoda nie wymaga żadnych parametrów żądania. Zwróconą listę kursów możesz pobrać id, aby użyć jej jako parametru żądania w innych wywołaniach interfejsu API. Jeśli nie masz żadnych kursów, możesz je utworzyć za pomocą metody
courses.create().
Możesz też zapoznać się z dokumentacją interfejsu Classroom API.