Na tej stronie znajdziesz listę typowych nieporozumień i szczególnych przypadków, które warto wziąć pod uwagę podczas projektowania i wdrażania dodatku do Google Classroom. Zachęcamy do wdrażania zabezpieczeń i testów, które obejmują te przypadki.
Pojęcia dotyczące Google Classroom
W tej sekcji omówiono przypadki szczególne i pojęcia związane z dodatkami, które mają zastosowanie do wszystkich funkcji Google Classroom.
Kursy i role użytkowników
Zajęcia to centralna jednostka organizacyjna, która łączy nauczycieli z uczniami. Kursy to najwyższy poziom organizacji w interfejsie Google Classroom API.
Pojedynczych użytkowników można dodawać do zajęć jako „nauczycieli” lub „uczniów”. Rola użytkownika w kursie nie jest powiązana z jego rolą w instytucji. Oznacza to, że uczeń należący do szkoły może być nauczycielem na zajęciach, a nauczyciele mogą być uczniami na zajęciach. Najczęściej kursy są regularnie zaplanowanymi zajęciami akademickimi, ale mogą też służyć do organizowania klubów studenckich lub doskonalenia zawodowego.
Poniższe informacje dotyczą wszystkich zajęć w Google Classroom.
Nauczyciele kursów:
- Kurs może mieć więcej niż 1 nauczyciela.
- W każdej chwili do kursu można dodawać nauczycieli.
- Nauczycieli można usunąć z zajęć w dowolnym momencie.
Element strumienia
Elementy strumienia to opublikowane treści udostępnione uczestnikom kursu. Deweloperzy i nauczyciele mogą tworzyć załączniki dodatków do 3 typów elementów strumienia: ogłoszeń, projektów i materiałów.
Nauczyciele tworzą ogłoszenia u góry strony Strumień w interfejsie Classroom. Nauczyciele tworzą projekty i materiały, klikając przycisk Utwórz na karcie Zadania. Programiści mogą tworzyć je za pomocą interfejsu Classroom API.
Projekt to element strumienia, w którym uczeń może przesłać pracę. Projekty to jedyny typ elementów strumienia, które mogą zawierać załączniki w postaci dodatków i wyświetlają się w zeszycie ocen.
Elementy strumienia:
- Projekt lub materiały mogą być przypisane do podzbioru uczniów na kursie.
- Zadanie może być ocenione lub nieocenione. Nauczyciele mogą w każdej chwili zmienić status oceniania zadania.
- Przypisanie może mieć więcej niż 1 załącznik.
- Projekt może zawierać załączniki różnych typów. Na przykład jedno zadanie może zawierać jednocześnie Dokumenty Google, filmy w YouTube i załączniki z dodatków.
- Przypisanie może zawierać załączniki dotyczące dodatku od więcej niż 1 programisty.
- Deweloperzy mogą uzyskiwać i modyfikować informacje o dowolnym elemencie strumienia za pomocą jednego z załączników dodatku.
- Deweloperzy mogą oddać, cofnąć lub zwrócić projekt ucznia, który zawiera jeden z ich załączników.
- Deweloperzy mogą ustawiać oceny tylko w przypadku poszczególnych projektów przesłanych przez uczniów w ramach stworzonych przez nich projektów.
Skopiowane elementy strumienia
Nauczyciele mogą kopiować elementy strumienia, kopiując zajęcia, używając ponownie projektu lub publikując element strumienia na wielu zajęciach. Aby dowiedzieć się, jak dodatek może obsługiwać te scenariusze, przeczytaj nasz przewodnik dotyczący kopiowania treści.
Instytucja użytkownika
Interfejs API Google Classroom nie zwraca identyfikatorów instytucji, budynku ani innych członkostw użytkownika na poziomie wyższym niż kurs.