Interfejs Google Classroom API udostępnia programistom, administratorom i kierownikom szkół interfejs programowania, który pozwala zarządzać zasobami Google Classroom. Możesz tworzyć oprogramowanie, które tworzy, pobiera i modyfikuje kursy i treści w Classroom.
Oto kilka typowych zastosowań:
- Zarządzanie kursami, listami uczniów i opiekunami
- Dodawanie projektów, ogłoszeń i materiałów szkoleniowych
- Przypisywanie ocen i modyfikowanie ustawień oceniania
- Generowanie danych do analizy
- Ułatwianie znajdowania i korzystania z treści lub narzędzi zewnętrznego dostawcy w Classroom
Czy interfejs API Classroom jest dla mnie odpowiednim rozwiązaniem?
Google udostępnia kilka usług, które ułatwiają interakcję z Classroom. Poniżej znajdziesz kilka typowych scenariuszy i zalecenia dotyczące usług, które mogą najlepiej odpowiadać Twoim potrzebom.
Modyfikowanie zasobów w Google Classroom
| Scenariusz | Zalecane rozwiązania |
|---|---|
| Chcę regularnie zarządzać dużą liczbą zajęć, użytkowników lub innych zasobów Classroom. Umiesz pisać kod i utrzymywać infrastrukturę oprogramowania. | pisać aplikacje korzystające z interfejsu Classroom API; |
| Chcę okazjonalnie zarządzać niewielką liczbą zasobów Classroom. Umiem pisać niewielkie ilości kodu z niewielkim nakładem pracy. | Używanie interfejsu Classroom API z Google Apps Script. |
| Chcę od czasu do czasu wprowadzać zmiany w poszczególnych zasobach Classroom. Potrafię pracować z komendami terminala. | Użyj Menedżera Google Apps. |
| Chcę uzyskać dużą liczbę raportów z informacjami o zdarzeniach w Classroom. | Użyj usługi BigQuery Data Transfer Service. |
| Chcę przeprowadzić dochodzenie w sprawie aktywności moich użytkowników. | Wygeneruj raporty w konsoli administracyjnej lub użyj interfejsu Reports API. |
Integracja z Google Classroom
| Scenariusz | Zalecane rozwiązania |
|---|---|
| Chcę, aby nauczyciele i uczniowie mogli wyświetlać moje treści w Classroom i je uruchamiać. | Utwórz dodatek do Classroom. |
| Chcę, aby nauczyciele kliknęli przycisk w mojej witrynie lub aplikacji, który umożliwia umieszczenie treści w Classroom. | Utwórz dodatek do Classroom i twórz załączniki za pomocą kodu. |
| Chcę, aby nauczyciele mogli kliknąć przycisk w naszej witrynie lub aplikacji, aby połączyć się z treściami w Classroom. | Tworzenie zadań za pomocą interfejsu API Classroom lub umieszczanie przycisków Udostępnij w Classroom. |
| Chcę, aby nauczyciele w Classroom mogli synchronizować się z systemem informacji o uczniach lub importować z niego informacje. | Wdrożyć OneRoster for SIS lub utworzyć zasoby i uzyskać do nich dostęp za pomocą interfejsu Classroom API. |
Pierwsze kroki
Nowi deweloperzy powinni wykonać te czynności przed rozpoczęciem nowego projektu:
- Przeczytaj nasz przewodnik dotyczący struktury interfejsu Classroom API.
- Dowiedz się więcej o ocenianiu, typach użytkowników, kwalifikowaniu się użytkowników i czynnościach administratora. Te przewodniki opisują pojęcia związane z Google Classroom i interfejsem Classroom API.
- Dowiedz się, jak działają żądania interfejsu Classroom API.
Aby rozpocząć tworzenie aplikacji, musisz wykonać wymagania wstępne. Wybierz odpowiednie zakresy interfejsu Classroom API, a następnie skonfiguruj środowisko i zacznij wysyłać żądania, korzystając z jednego z samouczków:
Eksperymentowanie z narzędziem Google APIs Explorer
Aby eksperymentalnie wywoływać metody na podstawie danych na żywo, użyj narzędzia Google APIs Explorer. Aby zacząć, nie musisz pisać kodu, ale pamiętaj, że działania wykonywane za pomocą Eksploratora interfejsów API mogą modyfikować istniejące dane.
Jednym ze sposobów wywołania metod jest wywołanie metody courses.list(). Ta metoda nie wymaga żadnych parametrów żądania. Możesz pobrać id z zwróconej listy kursów, aby użyć go jako parametr żądania w innych wywołaniach interfejsu API. Jeśli nie masz żadnych kursów, możesz utworzyć jeden za pomocą metody courses.create().
Możesz też zapoznać się z dokumentacją interfejsu Classroom API.