Студенты и преподаватели представляют собой определенные сопоставления между профилем пользователя и курсом, представляющие роль этого пользователя в курсе. Обозначения студента и преподавателя не являются глобальными: пользователь может быть назначен преподавателем одного курса и студентом другого. Обозначения «ученик» или «преподаватель» представляют собой набор разрешений для конкретного пользователя в конкретном курсе.
- Студенты
- Ресурс Student представляет пользователя, который зачислен в качестве студента на определенный курс. Студентам разрешено просматривать подробную информацию о курсе и преподавателях этого курса.
- Учителя
- Ресурс «Учитель» представляет пользователя, который преподает определенный курс. Преподавателям разрешено просматривать и изменять сведения о курсе, просматривать преподавателей и учащихся, а также управлять дополнительными преподавателями и учащимися.
Студенты и преподаватели идентифицируются по уникальному идентификатору или адресу электронной почты пользователя, возвращаемому API каталога . Текущий пользователь также может ссылаться на свой собственный идентификатор, используя сокращение "me"
.
Прямое добавление
Администраторам домена разрешено обходить поток приглашений и напрямую добавлять пользователей в своем домене в качестве преподавателей или студентов на курсы в своем домене. Курс считается принадлежащим администратору, если владелец курса находится в домене администратора. Для пользователей или курсов за пределами домена аутентифицированного администратора домена приложения должны получить согласие пользователя, отправив приглашение с помощью метода invitations.create()
.
Добавить или удалить учителей
Администраторы домена могут напрямую добавлять преподавателей в своем домене в курсы с помощью teachers.create()
, как показано в следующем примере:
.СЕТЬ
Джава
PHP
Питон
Если вы добавляете дополнительных учителей от имени аутентифицированного учителя, вы должны использовать метод invitations.create()
.
Вы можете удалить дополнительных учителей из курса с помощью метода teachers.delete()
. Это удаляет только указанного преподавателя из курса и не влияет на его назначение на другие курсы или на его профиль пользователя.
Зарегистрируйте или удалите студентов
Администраторы домена могут напрямую добавлять студентов в свой домен с помощью метода students.create()
, как показано в следующем примере:
.СЕТЬ
Джава
PHP
Питон
Если вы добавляете учеников от имени аутентифицированного преподавателя, вы должны использовать метод invitations.create()
.
Вы можете удалить студента из курса с помощью метода students.delete()
. Это удаляет только указанного студента из курса и не влияет на его зачисление на другие курсы или его профиль пользователя.
Получить курсы пользователя
Чтобы получить список курсов для студента или преподавателя, вызовитеcourses.list courses.list()
и укажите studentId
или teacherId
соответствующего пользователя.
Получить профиль пользователя
Чтобы получить сокращенный профиль пользователя, включая идентификатор и имя, вызовите userProfiles.get()
, указав идентификатор пользователя, адрес электронной почты или «я» для запрашивающего пользователя.
Чтобы получить поле emailAddress
, необходимо включить область classroom.profile.emails
.
Возвращаемый идентификатор соответствует ресурсу Directory API Users , содержащему соответствующий studentId
или teacherId
.
Управление владельцами курсов
Администраторы домена могут передавать права владения курсами между преподавателями. Важную информацию см. в разделе «Передача владения курсом» .