Peran siswa dan pengajar di Google Classroom merepresentasikan peran pengguna dalam kursus. Pengguna dapat ditetapkan sebagai pengajar dalam satu kursus dan siswa dalam kursus lainnya. Penunjukan "siswa" atau "pengajar" mewakili serangkaian izin untuk pengguna tertentu dalam kursus tertentu.
- Siswa
Resource
Studentmewakili pengguna yang terdaftar sebagai siswadalam kursus tertentu. Siswa diizinkan untuk melihat detail kursus dan pengajar untuk kursus tersebut.
- Guru
Resource
Teachermewakili 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, sebagaimana ditampilkan oleh Directory API.
Pengguna saat ini juga dapat merujuk ke ID mereka sendiri menggunakan singkatan "me".
Izin pengelolaan langsung menggunakan Classroom API
Administrator, siswa, dan pengajar memiliki izin yang berbeda saat menambahkan atau menghapus pengguna secara langsung dari kursus menggunakan Classroom API.
Administrator
Administrator domain diizinkan untuk melewati 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 mengirim undangan menggunakan
metode invitations.create.
Siswa
Siswa dapat menambahkan diri mereka ke kursus dengan memanggil
students.create dan menentukan enrollmentCode kursus. enrollmentCode adalah ID unik untuk kursus yang disertakan dalam resource Course. Di aplikasi web Classroom, enrollmentCode tersedia di tab forum dan halaman detail kursus.
Guru
Pengajar tidak dapat menambahkan pengguna secara langsung 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 diri mereka ke kursus.
2 Siswa hanya dapat menghapus diri mereka 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 menghapus pengajar yang ditentukan dari kursus dan tidak memengaruhi penugasannya ke kursus lain atau profil penggunanya.
Mengelola pemilik kursus
Administrator domain dapat mentransfer kepemilikan kursus antar-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 menambahkan dirinya sendiri langsung 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 akan 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.
Anda tidak dapat menetapkan studentId dan teacherId dalam satu permintaan courses.list(). Untuk mengambil daftar kursus tempat pengajar dan siswa tertentu terdaftar, buat permintaan courses.list() terpisah untuk setiap pengguna. Kemudian, temukan
persimpangan dari kedua kumpulan hasil.
Mengambil profil pengguna
Untuk mengambil profil pengguna, termasuk ID dan nama, panggil
userProfiles.get dengan ID, email, atau "me" pengguna untuk
pengguna yang meminta. Untuk mengambil kolom emailAddress, Anda harus menyertakan cakupan
classroom.profile.emails.
id yang ditampilkan sesuai dengan resource Directory API Users yang berisi
studentId atau teacherId yang cocok.