Role ucznia i nauczyciela w Google Classroom odzwierciedlają rolę użytkownika na zajęciach. Użytkownik może być nauczycielem na jednych zajęciach, a uczniem na innych. Oznaczenie „uczeń” lub „nauczyciel” oznacza zestaw uprawnień danego użytkownika w danym kursie.
- Uczniowie
- Zasób
Studentreprezentuje użytkownika, który jest uczniem na konkretnych zajęciach. Uczniowie mogą wyświetlać szczegóły zajęć i nauczycieli prowadzących te zajęcia. - Nauczyciele
- Zasób
Teacherreprezentuje użytkownika, który prowadzi konkretny kurs. Nauczyciele mogą wyświetlać i zmieniać szczegóły kursu, wyświetlać nauczycieli i uczniów oraz zarządzać dodatkowymi nauczycielami i uczniami. Każdy kurs ma nauczyciela głównego, czyli właściciela zajęć, który może zarządzać ustawieniami, np. przenosić własność zajęć.
Uczniowie i nauczyciele są identyfikowani na podstawie unikalnego identyfikatora lub adresu e-mail użytkownika zwróconego przez interfejs Directory API.
Bieżący użytkownik może też odwoływać się do swojego identyfikatora za pomocą skrótu "me".
bezpośrednie uprawnienia do zarządzania za pomocą interfejsu Classroom API.
Administratorzy, uczniowie i nauczyciele mają różne uprawnienia podczas bezpośredniego dodawania lub usuwania użytkowników z zajęć za pomocą interfejsu Classroom API.
Administratorzy
Administratorzy domen mogą pominąć proces zapraszania i bezpośrednio dodawać uczniów i nauczycieli do zajęć, jeśli spełnione są te warunki:
- Dodawany użytkownik należy do domeny administratora.
- Główny nauczyciel zajęć lub właściciel zajęć należy do domeny administratora.
W przypadku użytkowników lub zajęć spoza domeny administratora aplikacje muszą uzyskać zgodę użytkownika, wysyłając zaproszenie za pomocą metody invitations.create().
Uczniowie
Uczniowie mogą dodać się do kursu, wywołując funkcję students.create() i podając enrollmentCode kursu. enrollmentCode to unikalny identyfikator zajęć uwzględnionych w zasobie Course. W aplikacji internetowej Classroom ikona enrollmentCode jest dostępna na karcie strumienia i na stronie z informacjami o kursie.
Nauczyciele
Nauczyciele nie mogą bezpośrednio dodawać użytkowników do zajęć. Aby zaprosić uczniów i innych nauczycieli, muszą użyć metody invitations.create().
W tabeli poniżej opisano, który użytkownik może wysyłać żądania do metod create i delete zasobów Teacher i Student.
| Administrator | Nauczyciel | Uczeń | |
|---|---|---|---|
CreateTeacher |
✔️ | ✖️ | ✖️ |
DeleteTeacher |
✔️ | ✔️ | ✖️ |
CreateStudent |
✔️ | ✖️ | ✔️ 1 |
DeleteStudent |
✔️ | ✔️ | ✔️ 2 |
1 Uczeń może dodać się tylko do zajęć.
2 Uczeń może usunąć się z zajęć.
Zarządzanie nauczycielami
Administratorzy domen mogą bezpośrednio dodawać nauczycieli z ich domeny do zajęć za pomocą teachers.create(), jak pokazano w tym przykładzie:
.NET
Java
PHP
Python
Nauczyciele współprowadzący mogą usuwać innych nauczycieli z zajęć za pomocą metody teachers.delete(). Spowoduje to usunięcie tylko określonego nauczyciela z kursu i nie wpłynie na jego przypisanie do innych kursów ani na jego profil użytkownika.
Zarządzanie właścicielami zajęć
Administratorzy domeny mogą przekazywać własność zajęć pomiędzy nauczycielami. Ważne informacje znajdziesz w sekcji Aktualizowanie właściciela szkolenia.
Zarządzanie uczniami
Administratorzy domen mogą bezpośrednio dodawać uczniów w swojej domenie za pomocą metody students.create(). Jeśli uczeń dodaje się bezpośrednio do zajęć, wymagane jest pole enrollmentCode.
.NET
Java
PHP
Python
Usunięcie ucznia z zajęć za pomocą metody students.delete() spowoduje usunięcie go tylko z określonych zajęć i nie wpłynie na jego rejestrację w innych zajęciach ani na jego profil użytkownika.
Pobieranie kursów użytkownika
Aby pobrać listę zajęć ucznia lub nauczyciela, wywołaj funkcję courses.list() i podaj identyfikator studentId lub teacherId odpowiedniego użytkownika.
Pobieranie profilu użytkownika
Aby pobrać profil użytkownika, w tym jego identyfikator i nazwę, wywołaj funkcję userProfiles.get() z identyfikatorem użytkownika, adresem e-mail lub „mną” w przypadku użytkownika przesyłającego żądanie. Aby pobrać pole emailAddress, musisz uwzględnić zakres classroom.profile.emails.
Zwrócony identyfikator id odpowiada zasobom Directory API Users zawierającym pasujący identyfikator studentId lub teacherId.