Google Classroom API menyediakan antarmuka pemrograman bagi developer software, administrator, dan pimpinan sekolah untuk mengelola resource Google Classroom. Anda dapat membuat software yang membuat, mengambil, dan mengubah kursus Kelas dan kontennya.
Beberapa kasus penggunaan umum antara lain:
- Mengelola kursus, daftar nama siswa, dan wali
- Menambahkan tugas, pengumuman, dan materi kursus
- Menetapkan nilai dan mengubah setelan penilaian
- Membuat data untuk analisis
- Membuat konten atau alat dari penyedia luar dapat ditemukan dan diakses dalam Classroom
Apakah Classroom API adalah solusi yang tepat untuk saya?
Google menyediakan beberapa produk untuk membantu Anda berinteraksi dengan Classroom. Berikut adalah beberapa skenario umum dan rekomendasi untuk produk yang mungkin paling sesuai dengan kebutuhan Anda.
Mengubah materi Google Classroom
| Skenario | Solusi yang direkomendasikan |
|---|---|
| Saya ingin mengelola banyak sekali kursus, pengguna, atau materi Classroom lainnya secara rutin. Saya nyaman menulis kode dan mengelola infrastruktur software. | Menulis aplikasi yang menggunakan Classroom API. |
| Saya ingin sesekali mengelola sejumlah kecil materi Classroom. Saya nyaman menulis kode dalam jumlah kecil dengan sedikit overhead. | Gunakan Classroom API dengan Google Apps Script. |
| Saya ingin sesekali melakukan perubahan pada setiap materi Classroom. Saya merasa nyaman menggunakan perintah terminal. | Gunakan Google Apps Manager. |
| Saya ingin ada banyak laporan dengan detail tentang acara di Classroom. | Gunakan Data Transfer Service BigQuery. |
| Saya ingin melakukan penyelidikan tentang aktivitas pengguna. | Buat laporan di konsol Admin atau gunakan Reports API. |
Mengintegrasikan dengan Google Classroom
| Skenario | Solusi yang direkomendasikan |
|---|---|
| Saya ingin pengajar dan siswa melihat serta meluncurkan konten saya di Classroom. | Buat add-on Classroom. |
| Saya ingin pengajar mengklik tombol di situs atau aplikasi saya yang menyematkan konten saya di Classroom. | Buat add-on Classroom dan buat lampiran secara terprogram. |
| Saya ingin pengajar mengklik tombol di situs atau aplikasi saya untuk menautkan konten saya di Classroom. | Buat materi menggunakan Classroom API atau sematkan tombol Berbagi ke Classroom. |
| Saya ingin pengajar Classroom menyinkronkan atau mengimpor informasi dari Sistem Informasi Siswa saya. | Terapkan OneRoster untuk SIS atau buat dan akses resource menggunakan Classroom API. |
Memulai
Developer baru dianjurkan untuk melakukan hal berikut sebelum memulai project baru:
- Baca panduan kami tentang struktur Classroom API.
- Baca tentang nilai, jenis pengguna, kelayakan pengguna, dan tindakan administrator. Panduan ini menjelaskan konsep yang unik untuk Google Classroom dan Classroom API.
- Memahami cara kerja permintaan API Classroom.
Untuk mulai mengembangkan, pastikan Anda telah menyelesaikan langkah-langkah prasyarat. Pilih cakupan Classroom API yang sesuai dengan kebutuhan Anda, lalu siapkan lingkungan dan mulai buat permintaan dengan mengikuti salah satu panduan memulai:
Bereksperimen dengan Google APIs Explorer
Untuk bereksperimen dengan metode panggilan pada data langsung, coba gunakan Google APIs Explorer. Anda tidak perlu menulis kode apa pun untuk memulai, tetapi perlu diketahui bahwa tindakan yang Anda lakukan menggunakan API Explorer dapat mengubah data yang ada.
Salah satu cara untuk mulai memanggil metode adalah dengan memanggil metode courses.list(). Metode ini tidak memerlukan parameter permintaan apa pun dan Anda dapat mengambil
id dari daftar kursus yang ditampilkan untuk digunakan sebagai parameter permintaan untuk
panggilan API lainnya. Jika tidak memiliki kursus, Anda dapat membuatnya menggunakan
metode courses.create().
Anda juga dapat menjelajahi referensi Classroom API.