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 do tworzenia, pobierania i modyfikowania zajęć Classroom oraz ich treści.
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ą kursów, użytkowników lub innych zasobów Classroom. Umiem 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ę korzystać z poleceń w terminalu. | Użyj Menedżera Google Apps. |
| Chcę uzyskać dużą liczbę raportów z informacjami o zdarzeniach w Classroom. | użyć 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 zobaczyli i uruchamiali moje treści w Classroom. | Utwórz dodatek do Classroom. |
| Chcę, aby nauczyciele klikali przycisk na mojej stronie lub w aplikacji, które pozwalają umieścić moje materiały w Classroom. | Utwórz dodatek do Classroom i utwórz załączniki. |
| Chcę, aby nauczyciele mogli kliknąć przycisk w naszej witrynie lub aplikacji, aby uzyskać dostęp do treści w Classroom. | Tworzenie zadań za pomocą interfejsu API Classroom lub umieszczanie przycisków Udostępnij w Classroom. |
| Chcę, aby nauczyciele w Classroom synchronizowali z moim systemem informacji o uczniach lub importowali 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 po strukturze interfejsu API Classroom.
- 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, wykonaj wstępne kroki. 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. Ze zwróconej listy kursów możesz pobrać id, który będzie używany 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.