Kelayakan pengguna

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.

Istilah Penting: Pengguna yang memenuhi syarat memiliki kemampuan untuk menggunakan fitur Classroom tertentu jika mereka memenuhi persyaratan fitur.

Poin Penting: Kemampuan ditentukan secara terpisah untuk setiap pengguna dan dapat berubah seiring waktu.

Fitur dengan persyaratan kelayakan

Fitur Classroom API berikut hanya tersedia untuk pengguna yang memenuhi syarat:

• Membuat lampiran add-on Classroom
• Mengubah setelan periode penilaian

Menentukan kemampuan pengguna

Permintaan ke Classroom API dibuat atas nama masing-masing pengguna. Oleh karena itu, Anda harus memeriksa apakah pengguna memiliki kemampuan yang sesuai sebelum mengeluarkan permintaan API dengan persyaratan kelayakan.

Poin Penting: Pertimbangkan untuk memeriksa kemampuan pengguna secara proaktif sehingga Anda dapat menyesuaikan tampilan atau perilaku produk agar cocok dengan fitur Classroom yang dapat mereka akses.

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 memiliki akses ke add-on Classroom yang dimiliki oleh project Google Cloud yang meminta, teruskan nilai CREATE_ADD_ON_ATTACHMENT.
• Untuk melihat apakah pengguna dapat mengubah setelan periode penilaian, teruskan UPDATE_GRADING_PERIOD_SETTINGS.

Selanjutnya, periksa kolom allowed dalam respons. Jika allowed adalah true, berarti pengguna memiliki akses ke Capability yang dipilih. Selanjutnya, Anda dapat membuat permintaan API terkait Capability atas nama pengguna.

Penting: Meskipun pengguna memenuhi syarat, permintaan API yang bergantung pada kelayakan masih dapat gagal. Kelayakan menyiratkan bahwa pengguna dapat menggunakan fitur Classroom, bukan berarti permintaan tertentu akan berhasil.