Uczniowie i nauczyciele to konkretne powiązania między profilem użytkownika a zajęciami, które reprezentują jego rolę na zajęciach. Określenia ucznia i nauczyciela nie są globalne: użytkownika można przypisać jako nauczyciela na jednych zajęciach, a ucznia na innych. Oznaczenie „uczeń” lub „nauczyciel” oznacza zbiór uprawnień dla konkretnego użytkownika na danych zajęciach.
- Uczniowie
- Zasób ucznia reprezentuje użytkownika zarejestrowanego na zajęciach. Uczniowie mogą wyświetlać szczegóły zajęć i nauczycieli biorących udział w tych zajęciach.
- Nauczyciele
- Zasób dla nauczyciela reprezentuje użytkownika, który prowadzi konkretny kurs. Nauczyciele mogą wyświetlać i zmieniać szczegóły zajęć, wyświetlać nauczycieli i uczniów oraz zarządzać dodatkowymi nauczycielami i uczniami.
Uczniowie i nauczyciele są rozpoznawani na podstawie unikalnego identyfikatora lub adresu e-mail określonego przez interfejs Directory API.
Bieżący użytkownik może też odwoływać się do własnego identyfikatora za pomocą skrótu "me"
.
Dodawanie bezpośrednie
Administratorzy domeny mogą pomijać proces zapraszania i dodawać użytkowników bezpośrednio w domenie jako nauczyciele lub uczniowie do zajęć w swojej domenie. Kurs jest uważany za należący do domeny administratora, jeśli właściciel zajęć znajduje się w domenie administratora. W przypadku użytkowników lub kursów spoza domeny uwierzytelnionego administratora domeny aplikacje muszą uzyskać zgodę użytkownika, wysyłając zaproszenie, korzystając z metody invitations.create()
.
Dodawanie i usuwanie nauczycieli
Administratorzy domen mogą bezpośrednio dodawać nauczycieli ze swojej domeny do zajęć za pomocą usługi teachers.create()
, jak w tym przykładzie:
.NET
Java
PHP
Python
Jeśli dodajesz kolejnych nauczycieli w imieniu uwierzytelnionego nauczyciela, musisz użyć metody invitations.create()
.
Możesz usunąć dodatkowych nauczycieli z zajęć za pomocą metody teachers.delete()
. Spowoduje to tylko usunięcie określonego nauczyciela z zajęć i nie wpłynie na jego przypisanie do innych zajęć ani na jego profil użytkownika.
Rejestrowanie i usuwanie uczniów
Administratorzy domen mogą bezpośrednio dodawać uczniów w 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()
.
Możesz usunąć ucznia z zajęć, korzystając z metody students.delete()
. Spowoduje to usunięcie tylko danego ucznia z zajęć i nie wpłynie na rejestrację na inne kursy ani na profil użytkownika.
Pobieranie kursów użytkownika
Aby pobrać listę kursów dla ucznia lub nauczyciela, zadzwoń pod numer courses.list()
i podaj dane odpowiedniego użytkownika (studentId
) lub teacherId
.
Pobieranie profilu użytkownika
Aby pobrać skrócony profil, w tym identyfikator i nazwę użytkownika, wywołaj funkcję userProfiles.get()
z identyfikatorem, adresem e-mail lub napisem „ja” w imieniu użytkownika wysyłającego prośbę.
Aby pobrać pole emailAddress
, musisz uwzględnić zakres classroom.profile.emails
.
Zwrócony identyfikator odpowiada zasobowi interfejsu Directory API, który zawiera pasujący ciąg studentId
lub teacherId
.
Zarządzanie właścicielami zajęć
Administratorzy domeny mogą przenosić własność zajęć między nauczycielami. Ważne informacje znajdziesz w sekcji Przenoszenie własności zajęć.