Integracja z CourseWork

Deweloperzy mogą używać interfejsu Google Classroom API do obsługi zajęć w Google Classroom. Aplikacja, która korzysta z interfejsu API w ten sposób, jest nazywana CourseWorkintegracją.

Ta ścieżka integracji jest zwykle używana do tworzenia i oceniania projektów z linkami do zasobów poza Classroom. Zapewnia większy dostęp dla programistów do zarządzania materiałami szkolnymi niż przyciski udostępniania w Classroom.

Jak to działa

Główną funkcją CourseWork integracji jest tworzenie zadań, ogłoszeń i materiałów do zajęć oraz zarządzanie nimi za pomocą interfejsu Classroom API.

Przykładem typowej ścieżki użytkownika, którą umożliwia integracja z CourseWork, jest możliwość wyszukiwania, przypisywania i oceniania treści przez nauczycieli w Twojej witrynie lub aplikacji:

1. Nauczyciel loguje się w Twojej witrynie.
2. Nauczyciel znajduje lub tworzy treści, które chce udostępnić klasie. Nauczyciel klika przycisk w Twojej witrynie, aby wysłać te treści do Google Classroom.
3. Aplikacja wysyła prośbę do courses.courseWork.create. Żądanie zawiera w treści obiekt CourseWork, który zawiera:
   • Identyfikator kursu docelowego.
   • Tytuł projektu.
   • Tekstowy opis projektu.
   • link Material z adresem URL treści wybranej przez nauczyciela.
   • Opcjonalnie maksymalny wynik, jaki można uzyskać w przypadku wybranych treści.
4. W Classroom pojawi się nowe zadanie z załączonym linkiem. Link odnosi się do adresu URL określonego w żądaniu create. Przykład znajdziesz na rysunku 1.
5. W dzienniku ocen w Classroom pojawi się też nowa kolumna z projektem, w tym maksymalna liczba punktów, jeśli została podana.
6. Uczniowie otrzymują projekt i klikają link Material, aby otworzyć podany adres URL w nowej karcie i wyświetlić lub ukończyć treści w Twojej witrynie. Opcjonalnie możesz udostępnić uczniowi elementy sterujące, które pozwolą mu oddać projekt.
7. Opcjonalnie możesz wysłać prośbę do courses.courseWork.studentSubmissions.modifyAttachments o dodanie załączników do przesłanej przez ucznia pracy, np. pliku z Dysku Google lub link Material, który wskazuje pracę ucznia w Twojej witrynie.
8. Opcjonalnie możesz wysłać prośbę do courses.courseWork.studentSubmissions.patch o ustawienie oceny ucznia za projekt.

Rysunek 1. Widok nauczyciela podczas edytowania projektu utworzonego za pomocą integracji link Material CourseWork.

Możesz też zadzwonić pod numer courses.announcements.create lub courses.courseWorkMaterials.create, aby utworzyć ogłoszenie lub materiały do zajęć zamiast projektu. Szczegółowe opisy odpowiednich działań interfejsu Classroom API znajdziesz na stronach Tworzenie zajęć i zarządzanie nimi oraz Ustawianie i aktualizowanie ocen.

Uwagi

Zanim zdecydujesz, czy integracja CourseWork jest odpowiednia dla Twoich produktów, weź pod uwagę te kwestie.

• Musisz autoryzować użytkownika i poprosić go o zgodę. Wysyłasz żądania API w imieniu użytkownika. Oznacza to na przykład, że nie możesz tworzyć prac domowych na żadnych zajęciach w Google Classroom. Możesz to robić tylko na zajęciach, które prowadzi autoryzowany użytkownik.
• Musisz umożliwić użytkownikowi wybranie kursu, w ramach którego ma otrzymać treści. Rozważ użycie courses.list, aby uzyskać listę kursów prowadzonych przez użytkownika, a następnie umożliwić mu wybranie co najmniej jednego kursu z listy.
• Gdy użytkownik kliknie link Material w Classroom, link otworzy się w nowej karcie. Gdy otworzysz adres URL, serwer nie otrzyma żadnych informacji z Classroom.
• Nauczyciel może modyfikować lub usuwać materiały do zajęć niezależnie od dewelopera. Oznacza to, że wiedza dewelopera na temat kursu może stać się nieaktualna. Jeśli chcesz być na bieżąco ze zmianami w materiałach do nauki, rozważ skonfigurowanie powiadomień push o zmianach w materiałach.
• Nauczyciel może tworzyć materiały w interfejsie Classroom, wklejając linki do adresów URL w Twojej witrynie. Prace utworzone w ten sposób są własnością nauczyciela, więc nie możesz wyświetlać, modyfikować ani ustawiać ocen za przesłanie za pomocą interfejsu Classroom API.