Integrasi CourseWork

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

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

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

Cara kerjanya

Fitur inti 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, memberikan tugas, 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 kelasnya. Pengajar mengklik tombol di situs Anda untuk mengirim konten ini ke Google Classroom.
3. Aplikasi Anda mengirimkan permintaan ke courses.courseWork.create. Permintaan berisi objek CourseWork dalam isinya 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 diperoleh untuk konten yang dipilih.
4. Tugas baru akan muncul di Classroom dengan lampiran link. Link tersebut merujuk ke URL yang ditentukan dalam permintaan create. Lihat Contoh 1 untuk melihat contohnya.
5. Kolom baru untuk tugas juga 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 dan melihat atau menyelesaikan konten di situs Anda. Jika perlu, berikan kontrol bagi siswa untuk menyerahkan tugas.
7. Secara opsional, kirim 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, kirim permintaan ke courses.courseWork.studentSubmissions.patch untuk menetapkan nilai siswa untuk tugas.

Gambar 1. Tampilan pengajar saat mengedit tugas yang link Material 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 tugas kelas 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 menghalangi 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 izinnya. Anda membuat permintaan API atas nama pengguna. Artinya, misalnya, Anda tidak dapat membuat tugas di kursus Google Classroom mana pun; Anda hanya dapat membuat tugas di kursus yang diajar 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 tugas secara independen dari developer. Artinya, pengetahuan developer tentang materi kursus mungkin menjadi tidak relevan. Jika Anda perlu mengetahui perubahan dalam tugas kelas, pertimbangkan untuk menyiapkan notifikasi push untuk perubahan tugas kelas.
• Pengajar dapat membuat tugas 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 kiriman menggunakan Classroom API.