Na tej stronie znajdziesz listę typowych nieporozumień i przypadków skrajnych, które warto wziąć pod uwagę podczas projektowania i wdrażania dodatku do Classroom. Zachęcamy do wdrażania zabezpieczeń i testów, które obejmują te przypadki.
Pojęcia dotyczące Google Classroom
W tej sekcji omawiamy skrajne przypadki i pojęcia związane z dodatkami, które mają zastosowanie do całej zawartości 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 dodać 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 fragmenty opublikowanych treści udostępniane uczestnikom zajęć. Deweloperzy i nauczyciele mogą tworzyć załączniki dodatków do 3 typów elementów w strumieniu: ogłoszenia, 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 dowolnym momencie zmienić stan oceniania projektu.
- Przypisanie może mieć więcej niż 1 załącznik.
- Projekt może zawierać załączniki różnego typu. Na przykład jedno zadanie może zawierać jednocześnie załączniki z Dokumentów Google, filmy z YouTube i dodatki.
- 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ć element strumienia, kopiując zajęcia, ponownie używając projektu lub publikując element w strumieniu 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.