Integracja z CourseWork

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Deweloperzy mogą używać interfejsu API Google Classroom do interakcji z materiałami edukacyjnymi w Google Classroom. Aplikacja, która w taki sposób korzysta z interfejsu API, jest nazywana CourseWorkintegracją.

Ta ścieżka integracji jest zwykle używana do tworzenia i oceniania projektów z linkami do zasobów spoza Classroom. Zapewnia on deweloperom większy dostęp do zarządzania zajęciami niż przyciski Udostępnij w Classroom.

Jak to działa

Podstawową funkcją integracji z CourseWork jest tworzenie i zarządzanie projektami, ogłoszeniami oraz materiałami kursu za pomocą interfejsu Classroom API.

Przykładem typowej ścieżki użytkownika umożliwiającej integrację CourseWork jest umożliwienie nauczycielom znajdowania, przypisywania i oceniania treści w witrynie lub aplikacji:

1. Nauczyciel loguje się w Twojej witrynie.
2. Nauczyciel znajduje lub tworzy treści, którymi chce się podzielić z klasą. Nauczyciel klika przycisk w Twojej witrynie, aby wysłać te treści do Google Classroom.
3. Aplikacja wysyła żądanie do courses.courseWork.create. Żądanie zawiera w swojej treści obiekt CourseWork, który zawiera:
   • Identyfikator kursu docelowego.
   • Tytuł przypisania.
   • Tekstowy opis projektu.
   • link Material z adresem URL treści wybranych przez nauczyciela.
   • Opcjonalnie maksymalna możliwa ocena dla wybranych treści.
4. W Classroom pojawi się nowe zadanie z załączonym linkiem. Link odnosi się do adresu URL podanego w żądaniu create. Przykład znajdziesz na rysunku 1.
5. W zeszycie ocen Classroom pojawi się nowa kolumna dotycząca projektu, w której będzie widoczna 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 wykonać zadanie w witrynie. Opcjonalnie udostępnij uczniowi elementy sterujące, aby oddał projekt.
7. Opcjonalnie możesz wysłać prośbę do courses.courseWork.studentSubmissions.modifyAttachments o dodanie załączników do pracy przesłanej przez ucznia, takich jak plik z Dysku Google lub link Material wskazujący na 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 z link Material utworzonego przez integrację CourseWork.

Możesz też użyć funkcji 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 i zarządzanie pracami dydaktycznymi oraz Ustawianie i aktualizowanie ocen.

Uwagi

Zanim zdecydujesz, czy integracja z CourseWork jest odpowiednia dla Twojego produktu, weź pod uwagę te kwestie.

• Musisz autoryzować użytkownika i poprosić go o zgodę. Wysyłasz żądania interfejsu API w imieniu użytkownika. Oznacza to na przykład, że nie możesz tworzyć zadań z żadnych zajęć w Google Classroom. Możesz tworzyć zadania tylko na zajęciach prowadzonych przez upoważnionego użytkownika.
• Musisz umożliwić użytkownikowi wybranie kursu, aby mógł otrzymać treści. Rozważ użycie interfejsu courses.list, aby uzyskać listę kursów prowadzonych przez użytkownika, a następnie zezwolić użytkownikowi na wybranie co najmniej jednego kursu z tej listy.
• Gdy użytkownik kliknie link Material w Classroom, link otworzy się w nowej karcie. Twój serwer nie otrzyma żadnych informacji z Classroom, gdy otworzysz adres URL.
• Nauczyciel może modyfikować lub usuwać treści zajęć niezależnie od dewelopera. Oznacza to, że wiedza programisty na temat kursu może się zdezaktualizować. Jeśli chcesz być na bieżąco ze zmianami w programie nauczania, rozważ skonfigurowanie powiadomień push dotyczących zmian w programie.
• Nauczyciel może tworzyć zadania w interfejsie Classroom, wklejając linki do adresów URL w swojej witrynie. Zadania utworzone w ten sposób są własnością nauczyciela, więc nie będzie można wyświetlać, modyfikować ani ustawiać ocen za przesłane prace za pomocą interfejsu Classroom API.