Peran siswa dan pengajar di Google Classroom mewakili peran pengguna dalam kursus. Pengguna dapat ditetapkan sebagai pengajar di satu kursus dan sebagai siswa di kursus lain. Penunjukan "siswa" atau "pengajar" mewakili kumpulan izin untuk pengguna tertentu di kursus tertentu.
- Siswa
- Resource
Student
mewakili pengguna yang terdaftar sebagai siswa di kursus tertentu. Siswa diizinkan untuk melihat detail kursus dan pengajar untuk kursus tersebut. - Guru
- Resource
Teacher
mewakili pengguna yang mengajar kursus tertentu. Pengajar diizinkan untuk melihat dan mengubah detail kursus, melihat pengajar dan siswa, serta mengelola pengajar dan siswa tambahan. Setiap kursus memiliki pengajar utama, atau pemilik kursus, yang merupakan pengajar yang dapat mengelola setelan seperti transfer kepemilikan kursus.
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"
.
Izin pengelolaan langsung menggunakan Classroom API
Administrator, siswa, dan pengajar memiliki izin yang berbeda saat menambahkan atau menghapus pengguna dari kursus secara langsung menggunakan Classroom API.
Administrator
Administrator domain diizinkan untuk mengabaikan alur undangan dan langsung menambahkan siswa dan pengajar ke kursus jika kondisi berikut terpenuhi:
- Pengguna yang ditambahkan adalah bagian dari domain administrator.
- Pengajar utama kursus, atau pemilik kursus, adalah bagian dari domain administrator.
Untuk pengguna atau kursus di luar domain administrator, aplikasi harus
mendapatkan izin pengguna dengan mengirimkan undangan menggunakan
metode invitations.create()
.
Siswa
Siswa dapat menambahkan diri ke kursus dengan memanggil
students.create()
dan menentukan enrollmentCode
kursus. enrollmentCode
adalah ID unik untuk kursus yang
disertakan di resource Course
. Di aplikasi web
Classroom, enrollmentCode
tersedia di tab forum dan halaman
detail kursus.
Guru
Pengajar tidak dapat langsung menambahkan pengguna ke kursus dan harus menggunakan
metode invitations.create()
untuk mengundang siswa dan
pengajar lain ke kursus.
Tabel berikut menjelaskan pengguna mana yang diizinkan untuk membuat permintaan ke
metode create
dan delete
untuk resource Teacher
dan Student
.
Administrator | Pengajar | Pelajar | |
---|---|---|---|
CreateTeacher |
✔️ | ✖️ | ✖️ |
DeleteTeacher |
✔️ | ✔️ | ✖️ |
CreateStudent |
✔️ | ✖️ | ✔️ 1 |
DeleteStudent |
✔️ | ✔️ | ✔️ 2 |
1 Siswa hanya dapat menambahkan dirinya ke kursus.
2 Siswa hanya dapat menghapus dirinya sendiri dari kursus.
Mengelola 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
Rekan pengajar dapat menghapus pengajar lain 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.
Mengelola pemilik kursus
Administrator domain dapat mentransfer kepemilikan kursus antara pengajar. Lihat bagian Memperbarui pemilik kursus untuk mengetahui detail penting.
Mengelola siswa
Administrator domain dapat langsung menambahkan siswa dalam domain mereka dengan metode
students.create()
. Jika siswa langsung menambahkan diri mereka ke kursus, enrollmentCode
diperlukan.
.NET
Java
PHP
Python
Menghapus siswa dari kursus menggunakan metode students.delete()
hanya akan menghapusnya dari kursus yang ditentukan dan tidak memengaruhi pendaftarannya di 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 pengguna, termasuk ID dan nama, panggil
userProfiles.get()
dengan ID, email, atau "saya" 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.