Integrasi CourseWork

Developer dapat menggunakan Google Classroom API untuk berinteraksi dengan tugas mata pelajaran di Google Classroom. Aplikasi yang menggunakan API dengan cara ini disebut sebagai integrasi CourseWork.

Poin Penting: Integrasi CourseWork memungkinkan developer secara terprogram mengakses dan mengubah status pengumuman, materi kursus, tugas, dan kiriman siswa Google Classroom. Pilih jalur ini jika Anda memerlukan cara hemat biaya untuk mengirim konten ke Classroom.

Jalur integrasi ini biasanya digunakan untuk membuat dan menilai tugas dengan link ke materi di luar Classroom. API ini memberikan lebih banyak akses developer ke pengelolaan materi dibandingkan dengan tombol Berbagi Classroom.

Cara kerjanya

Fitur inti dari integrasi CourseWork adalah pembuatan dan pengelolaan tugas, pengumuman, dan materi kursus menggunakan Classroom API.

Salah satu contoh perjalanan pengguna umum yang diaktifkan oleh integrasi CourseWork adalah memungkinkan pengajar menemukan, menetapkan, dan menilai konten dari dalam situs atau aplikasi Anda:

1. Pengguna pengajar login ke situs Anda.
2. Pengajar menemukan atau membuat konten yang ingin dibagikan kepada kelas. Pengajar mengklik tombol di situs Anda untuk mengirim konten ini ke Google Classroom.
3. Aplikasi Anda mengeluarkan permintaan ke courses.courseWork.create. Permintaan berisi objek CourseWork dalam isi yang berisi:
   • ID kursus tujuan.
   • Judul tugas.
   • Deskripsi teks untuk tugas.
   • link Material dengan URL ke konten yang dipilih oleh pengajar.
   • Secara opsional, skor maksimum yang dapat dicapai untuk konten yang dipilih.
4. Tugas baru akan muncul di Classroom dengan lampiran link. Link ini merujuk ke URL yang ditentukan dalam permintaan create. Lihat Gambar 1 sebagai contoh.
5. Kolom baru untuk tugas juga akan muncul di buku nilai Classroom, termasuk skor maksimum jika diberikan.
6. Siswa menerima tugas dan mengklik link Material untuk membuka URL yang diberikan di tab baru, lalu melihat atau menyelesaikan konten di situs Anda. Jika ingin, berikan kontrol bagi siswa untuk menyerahkan tugas.
7. Jika ingin, kirimkan permintaan ke courses.courseWork.studentSubmissions.modifyAttachments untuk menambahkan lampiran ke kiriman siswa, seperti file Google Drive atau link Material yang mengarah ke tugas siswa di situs Anda.
8. Secara opsional, buat permintaan ke courses.courseWork.studentSubmissions.patch untuk menetapkan nilai siswa untuk tugas.

Gambar 1. Tampilan pengajar saat mengedit tugas dengan link Material yang dibuat oleh integrasi CourseWork.

Atau, Anda dapat memanggil courses.announcements.create atau courses.courseWorkMaterials.create untuk membuat pengumuman atau materi kursus, bukan tugas. Lihat halaman Membuat & mengelola materi kursus dan Menetapkan & memperbarui nilai untuk mengetahui deskripsi mendetail tentang tindakan Classroom API yang relevan.

Pertimbangan

Poin Penting: Ada beberapa batasan penting untuk integrasi CourseWork. Jika hal ini mencegah Anda mewujudkan produk, pertimbangkan untuk membuat add-on Google Classroom.

Perhatikan hal-hal berikut sebelum memutuskan apakah integrasi CourseWork adalah pilihan yang tepat untuk kebutuhan produk Anda.

• Anda harus memberikan otorisasi kepada pengguna dan meminta izin mereka. Anda membuat permintaan API atas nama pengguna. Artinya, misalnya, Anda tidak dapat membuat tugas kursus di kursus Google Classroom apa pun; Anda hanya dapat membuat tugas kursus di kursus yang diajarkan oleh pengguna yang diberi otorisasi.
• Anda memerlukan cara bagi pengguna untuk memilih kursus guna menerima konten. Pertimbangkan untuk menggunakan courses.list guna mendapatkan daftar kursus yang diajarkan oleh pengguna, lalu izinkan pengguna memilih satu atau beberapa kursus dari daftar.
• Saat pengguna mengklik link Material di Classroom, link akan terbuka di tab baru. Server Anda tidak akan menerima informasi apa pun dari Classroom saat URL dibuka.
• Pengajar dapat mengubah atau menghapus materi kursus secara independen dari developer. Artinya, pengetahuan developer tentang materi kursus mungkin menjadi usang. Jika Anda perlu mengetahui perubahan pada materi kursus, pertimbangkan untuk menyiapkan notifikasi push untuk perubahan materi kursus.
• Pengajar dapat membuat materi di UI Classroom dengan menempelkan link ke URL di situs Anda. Tugas yang dibuat dengan cara ini hanya dimiliki oleh pengajar, sehingga Anda tidak akan dapat melihat, mengubah, atau menetapkan nilai tugas menggunakan Classroom API.