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 di kursus lainnya. Penetapan "siswa" atau "pengajar" merepresentasikan sekumpulan izin untuk pengguna tertentu dalam kursus tertentu.
- Siswa
- Referensi Siswa mewakili pengguna yang terdaftar sebagai siswa di 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"
.
Penambahan 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 yang diautentikasi, aplikasi harus mendapatkan izin pengguna dengan mengirimkan undangan menggunakan metode invitations.create()
.
Menambahkan atau menghapus pengajar
Administrator domain dapat langsung menambahkan pengajar dalam domain mereka 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 tugas mereka ke kursus lain atau
profil pengguna.
Mendaftarkan atau menghapus siswa
Administrator domain dapat langsung menambahkan siswa dalam domain mereka dengan metode
students.create()
, seperti ditunjukkan dalam contoh berikut:
.NET
Java
PHP
Python
Jika menambahkan siswa atas nama pengajar yang diautentikasi, Anda harus menggunakan
metode invitations.create()
.
Anda dapat menghapus siswa dari kursus dengan metode students.delete()
. Tindakan ini hanya akan 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 singkat, termasuk ID dan nama, bagi 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 Pengguna Directory API
yang berisi studentId
atau teacherId
yang cocok.
Kelola pemilik kursus
Administrator domain dapat mentransfer kepemilikan kursus di antara pengajar. Lihat bagian Mentransfer kepemilikan kursus untuk detail penting.