Meskipun developer mana pun dapat membuat permintaan ke Google Classroom API, beberapa fitur Google Classroom hanya tersedia untuk pengguna tertentu. Setiap fitur dapat memiliki persyaratan yang berbeda, seperti memiliki jenis lisensi Google Workspace for Education tertentu. Untuk mengetahui perincian mendetail tentang fitur di setiap tingkat lisensi Google Workspace for Education, lihat halaman perbandingan edisi.
Fitur dengan persyaratan kelayakan
Fitur Classroom API berikut hanya tersedia untuk pengguna yang memenuhi syarat:
- Membuat lampiran add-on Classroom
- Mengubah setelan periode penilaian
- Membuat, memperbarui, dan menghapus rubrik
Menentukan kemampuan pengguna
Permintaan ke Classroom API dibuat atas nama pengguna perorangan. Oleh karena itu, Anda harus memeriksa apakah pengguna memiliki kemampuan yang sesuai sebelum mengeluarkan permintaan API dengan persyaratan kelayakan.
Untuk menentukan apakah pengguna memiliki kemampuan tertentu, buat permintaan API ke metode checkUserCapability. Sertakan jenis Capability yang sesuai
untuk fitur Classroom yang ingin Anda gunakan. Tentukan
Capability yang sesuai untuk setiap fitur:
| Untuk melihat apakah pengguna... | Capability |
|---|---|
| Memiliki akses ke add-on Classroom yang dimiliki oleh project Google Cloud yang meminta | CREATE_ADD_ON_ATTACHMENT |
| Dapat mengubah setelan periode penilaian | UPDATE_GRADING_PERIOD_SETTINGS |
| Dapat membuat atau mengubah rubrik | CREATE_RUBRIC |
Selanjutnya, periksa kolom allowed dalam respons. Jika allowed adalah true, pengguna memiliki akses ke Capability yang dipilih. Kemudian, Anda dapat membuat permintaan API yang terkait dengan Capability atas nama pengguna.