Siswa dan pengajar adalah pemetaan spesifik antara profil pengguna dan kursus, yang mewakili peran pengguna tersebut dalam kursus. Penetapan siswa dan pengajar tidak bersifat global: pengguna dapat ditetapkan sebagai pengajar untuk satu kursus dan siswa dalam kursus lainnya. Penetapan "siswa" atau "pengajar" mewakili serangkaian izin untuk pengguna tertentu dalam kursus tertentu.
- Siswa
- Resource siswa mewakili pengguna yang terdaftar sebagai siswa dalam kursus tertentu. Siswa diizinkan untuk melihat detail kursus dan pengajar untuk kursus tersebut.
- Guru
- Referensi Pengajar mewakili pengguna yang mengajar kursus tertentu. Pengajar diizinkan untuk melihat dan mengubah detail kursus, melihat pengajar dan siswa, serta mengelola pengajar dan siswa tambahan.
Siswa dan pengajar diidentifikasi berdasarkan ID unik atau alamat email
pengguna, seperti yang ditampilkan oleh
Directory API.
Pengguna saat ini juga dapat merujuk ke ID-nya sendiri menggunakan singkatan "me"
.
Menambahkan langsung
Administrator domain diizinkan untuk mengabaikan alur undangan dan langsung menambahkan pengguna dalam domain mereka sebagai pengajar atau siswa ke kursus dalam domain mereka. Kursus dianggap dalam domain admin jika pemilik
kursus berada di domain admin. Untuk pengguna atau kursus di luar domain administrator domain terautentikasi, aplikasi harus mendapatkan izin pengguna dengan mengirimkan undangan menggunakan metode invitations.create()
.
Menambahkan atau menghapus pengajar
Administrator domain dapat langsung menambahkan pengajar dalam domainnya ke kursus
dengan teachers.create()
, seperti yang ditunjukkan dalam contoh berikut:
.NET
Java
PHP
Python
Jika menambahkan pengajar tambahan atas nama pengajar yang diautentikasi,
Anda harus menggunakan metode invitations.create()
.
Anda dapat menghapus pengajar tambahan dari kursus dengan
metode teachers.delete()
. Tindakan ini hanya akan menghapus pengajar yang ditentukan
dari kursus dan tidak memengaruhi tugasnya ke kursus lain atau
profil penggunanya.
Mendaftarkan atau mengeluarkan siswa
Administrator domain dapat langsung menambahkan siswa dalam domain mereka dengan
metode students.create()
, seperti yang ditunjukkan dalam contoh berikut:
.NET
Java
PHP
Python
Jika menambahkan siswa atas nama pengajar yang diautentikasi, Anda harus menggunakan metode invitations.create()
.
Anda dapat mengeluarkan siswa dari kursus dengan
metode students.delete()
. Tindakan ini hanya menghapus siswa
yang ditentukan dari kursus dan tidak memengaruhi pendaftaran mereka ke kursus lain atau
profil penggunanya.
Mengambil kursus pengguna
Untuk mengambil daftar kursus bagi siswa atau pengajar, panggil
courses.list()
dan berikan studentId
atau teacherId
pengguna yang sesuai.
Mengambil profil pengguna
Untuk mengambil profil ringkas, termasuk ID dan nama, pengguna, panggil
userProfiles.get()
dengan ID, email, atau "saya" pengguna untuk
pengguna yang meminta.
Untuk mengambil kolom emailAddress
, Anda harus menyertakan
cakupan classroom.profile.emails
.
ID yang ditampilkan sesuai dengan
resource Users Directory API
yang berisi studentId
atau teacherId
yang cocok.
Kelola pemilik kursus
Administrator domain dapat mentransfer kepemilikan kursus antar-pengajar. Harap lihat bagian Mentransfer kepemilikan kursus untuk mengetahui detail penting.