Uczniowie i nauczyciele to konkretne mapowanie między profilem użytkownika a kursem, które reprezentuje jego rolę na zajęciach. Wyznaczenia uczniów i nauczycieli nie są globalne: użytkownik może zostać przypisany jako nauczyciel na jednych zajęciach, a uczeń na innych. Określenie „uczeń” lub „nauczyciel” oznacza zbiór uprawnień użytkownika w ramach określonych kursów.
- Uczniowie
- Zasób dla ucznia reprezentuje użytkownika, który jest zarejestrowany na zajęciach na określonych zajęciach. Uczniowie mogą wyświetlać szczegóły i nauczycieli zajęć.
- 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ą identyfikowani na podstawie unikalnych identyfikatorów i adresów e-mail, które są zwracane przez interfejs Directory API.
Bieżący użytkownik może również odwoływać się do swojego identyfikatora za pomocą skrótu "me"
.
Dodawanie bezpośrednie
Administratorzy domeny mogą pomijać proces zapraszania i bezpośrednio dodawać użytkowników w domenie jako nauczycieli lub uczniów do zajęć w swojej domenie. Kurs jest traktowany w ramach domeny administratora, jeśli jego właściciel należy do domeny administratora. W przypadku użytkowników i kursów 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 do swoich domen za pomocą teachers.create()
, tak jak w tym przykładzie:
.NET
Java
PHP
Python
Jeśli dodajesz nauczycieli w imieniu uwierzytelnionego nauczyciela, musisz użyć metody invitations.create()
.
Możesz usunąć nauczycieli z zajęć za pomocą metody teachers.delete()
. Spowoduje to tylko usunięcie z zajęć tych nauczycieli i nie wpłynie na ich przypisanie do innych zajęć czy do profilu użytkownika.
Rejestrowanie i usuwanie uczniów
Administratorzy domeny mogą bezpośrednio dodawać uczniów w domenie za pomocą metody students.create()
, jak pokazujemy 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ęć za pomocą metody students.delete()
. Spowoduje to usunięcie tylko tych uczniów z zajęć i nie wpłynie na ich rejestrację w innych kursach ani na profilu użytkownika.
Pobieranie kursów użytkownika
Aby pobrać listę kursów dla ucznia lub nauczyciela, wywołaj metodę courses.list()
i podaj odpowiednią wartość właściwości studentId
lub teacherId
użytkownika.
Pobieranie profilu użytkownika
Aby pobrać skrócony profil, w tym identyfikator i nazwę użytkownika, wywołaj metodę userProfiles.get()
z identyfikatorem użytkownika, adresem e-mail lub „mną” użytkownika, który wysłał prośbę.
Aby pobrać pole emailAddress
, musisz uwzględnić zakres classroom.profile.emails
.
Zwrócony identyfikator odpowiada zasobowi użytkowników Directory API zawierającym pasujący 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 kursu.