Uczniowie i nauczyciele to konkretne odwzorowania między profilem użytkownika a kursem, które wskazują rolę użytkownika w kursie. Użytkownik może być nauczycielem w jednym kursie, a uczniem w innym. Oznaczenie „uczeń” lub „nauczyciel” oznacza zestaw uprawnień danego użytkownika w danym kursie.
- Uczniowie
- Zasób „Student” reprezentuje 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 Nauczyciel reprezentuje 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.
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"
.
Dodawanie bezpośrednie
Administratorzy domen mogą pominąć proces zapraszania i bezpośrednio dodawać użytkowników z ich domeny jako nauczycieli lub uczniów do zajęć w domenie. Kurs jest uznawany za znajdujący się w domenie administratora, jeśli właściciel kursu znajduje się w domenie administratora. W przypadku użytkowników lub zajęć spoza domeny uwierzytelnionego administratora domeny aplikacje muszą uzyskać zgodę użytkownika, wysyłając zaproszenie za pomocą metody invitations.create()
.
Dodawanie i usuwanie nauczycieli
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
Jeśli dodajesz dodatkowych nauczycieli w imieniu nauczyciela uwierzytelnionego, musisz użyć metody invitations.create()
.
Dodatkowych nauczycieli możesz usunąć 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.
Rejestrowanie i usuwanie uczniów
Administratorzy domen mogą bezpośrednio dodawać uczniów w swojej domenie za pomocą metody students.create()
, jak pokazano w tym przykładzie:
.NET
Java
PHP
Python
Jeśli dodajesz uczniów w imieniu uwierzytelnionego nauczyciela, musisz użyć metody invitations.create()
.
Ucznia możesz usunąć z zajęć za pomocą metody students.delete()
. Spowoduje to usunięcie tylko wskazanego studenta z kursu i nie wpłynie na jego rejestrację w innych kursach ani na jego profil użytkownika.
Pobieranie kursów użytkownika
Aby pobrać listę kursów dla ucznia lub nauczyciela, wywołaj funkcję courses.list()
i podaj odpowiedni identyfikator studentId
lub teacherId
użytkownika.
Pobieranie profilu użytkownika
Aby pobrać skrócony profil użytkownika, w tym jego identyfikator i nazwę, wywołaj funkcję userProfiles.get()
, podając identyfikator użytkownika, jego adres e-mail lub „me” (ja).
Aby pobrać pole emailAddress
, musisz uwzględnić zakres classroom.profile.emails
.
Zwrócony identyfikator odpowiada zasobowi Directory API Users zawierającego pasujące wartości studentId
lub teacherId
.
Zarządzanie właścicielami zajęć
Administratorzy domen mogą przenosić własność zajęć między nauczycielami. Ważne informacje znajdziesz w sekcji Przenoszenie własności zajęć.