Pengantar

Tugas di Classroom disebut item CourseWork, yang dapat ditemukan di halaman Tugas Kelas dari kursus Classroom tertentu. Meskipun ada empat jenis item Tugas Kelas, panduan ini hanya berfokus pada jenis “Tugas”. Jika Anda ingin mempelajari cara mengelola jenis Tugas Kelas lainnya, baca panduan Mengelola Tugas Kelas.

Google Classroom memiliki dua cara untuk terintegrasi dengan alur kerja tugas: tombol berbagi Classroom dan Classroom API. Tombol berbagi memungkinkan pengguna berbagi konten sebagai item aliran apa pun melalui dialog pop-up Classroom, sedangkan Classroom API memungkinkan alur kerja penetapan dari awal yang mencakup membuat tugas, membuat dan mengelola pengiriman siswa, serta memberi nilai passback.

Di sini kita akan meninjau perbedaan utama antara kedua penawaran developer tersebut. Lebih khusus lagi, kita akan membahas perbedaan dalam penerapan dan setiap fase siklus proses tugas: pembuatan tugas, penyerahan siswa, dan penilaian/masukan.

Memahami siklus proses penugasan

Sebelum beralih ke perbedaan antara tombol berbagi dan CourseWork API, pertama-tama mari kita tentukan siklus proses tugas dalam konteks Classroom. Hal ini akan membantu Anda memahami cara pengajar dan siswa berinteraksi dengan tugas dalam Classroom.

Ada lima langkah utama yang perlu diingat saat berintegrasi dengan tugas Classroom:

1. Tugas telah dibuat.
2. Tugas dibagikan kepada siswa.
3. Siswa menyelesaikan tugas.
4. Siswa mengirimkan tugas kepada pengajar.
5. Tinjauan & nilai tugas pengajar.

Integrasi dengan tugas Classroom memungkinkan pengajar dan siswa bekerja antara Classroom dan aplikasi pihak ketiga dengan lancar. Daripada mengelola detail tugas atau kiriman siswa, pengguna dapat mengandalkan aplikasi Anda untuk mengelola detail ini untuk mereka.

Penerapan

Area perbedaan pertama antara tombol berbagi dan CourseWork API adalah implementation. Dari perspektif developer, tombol berbagi adalah metode yang lebih mudah untuk berbagi konten ke Classroom karena hanya memerlukan penyertaan resource JavaScript yang diperlukan dan penambahan tag tombol berbagi. Dalam bentuknya yang paling sederhana, integrasi tombol berbagi Classroom Anda dapat terlihat seperti cuplikan di bawah:

<script src="https://apis.google.com/js/platform.js" async defer></script>
<g:sharetoclassroom url="http://url-to-share" size="32"></g:sharetoclassroom>

Anda dapat mempelajari lebih lanjut cara mengintegrasikan Tombol Bagikan di sini.

Di sisi lain, CourseWork API adalah bagian dari Google Classroom API REST API, yang memerlukan penyiapan dan pengaktifan kunci API dengan Konsol Google Cloud serta mengikuti praktik terbaik untuk berintegrasi dengan API. Hal ini tidak terlalu mengkhawatirkan jika platform Anda sudah memanfaatkan fungsi Classroom API lainnya, seperti pembuatan daftar nama siswa.

Membuat & berbagi tugas

Meskipun tombol berbagi dan CourseWork API mengaktifkan dua langkah pertama alur kerja tugas, yaitu membuat dan membagikan tugas kepada siswa, ada beberapa perbedaan penting yang harus Anda pertimbangkan sebelum memilih solusi.

Pada intinya, kedua solusi tersebut memungkinkan kemampuan untuk memposting link atau file sebagai tugas ke Classroom. Hal ini berfungsi sebagai alur kerja yang efektif bagi pengajar yang terpaksa melakukan alur kerja salin dan tempel antara Classroom dan aplikasi pihak ketiga. Meskipun kedua solusi mendukung kemampuan untuk memposting konten sebagai tugas, Anda harus mempertimbangkan apakah aplikasi memerlukan fleksibilitas untuk memposting konten ini sebagai jenis Tugas Kelas lainnya, atau bahkan pengumuman.

Kedua penawaran ini menampilkan semua jenis postingan Classroom, kecuali Tugas Kuis. Ringkasan semua jenis postingan dan apakah postingan tersebut terekspos dapat ditemukan di bawah.

Jenis Postingan	Tombol berbagi	API CourseWork
Assignment	X	X
Tugas Kuis
Pertanyaan: Jawaban Singkat	X	X
Pertanyaan: Pilihan Ganda	X	X
Bahan	X	X
Pengumuman	X	X

Fungsi seperti menentukan judul dan deskripsi juga dapat ditentukan secara terprogram oleh aplikasi Anda untuk kedua solusi. Meskipun integrasi tombol berbagi memungkinkan pengguna menetapkan kolom seperti batas waktu, topik, mode individual, dan jumlah titik dalam dialog pop-up, kolom tersebut tidak dapat ditetapkan secara terprogram oleh aplikasi pihak ketiga. Di sisi lain, API mengekspos semua kolom tersebut untuk akses baca dan tulis.

Tombol berbagi juga tidak memungkinkan aplikasi Anda menentukan kolom khusus untuk jenis Pertanyaan, misalnya Opsi Pilihan Ganda.

Mengubah tugas

Menghilangkan kebutuhan untuk meminta pengguna menyinkronkan detail tugas mereka secara manual adalah salah satu manfaat integrasi dengan Classroom API. Tombol bagikan tidak memiliki fungsi untuk memperbarui atau menghapus tugas secara terprogram sehingga setiap perubahan yang diperlukan harus dilakukan oleh pengguna, melalui UI Classroom.

CourseWork API memberikan kemampuan untuk mengubah dan menghapus tugas yang dibuat oleh aplikasi Anda, serta kemampuan untuk mengambil detail tugas apa pun yang diposting ke kursus pengguna. Namun, perlu diketahui bahwa item Coursera yang tidak dibuat oleh konsol developer yang sama tidak dapat diubah oleh konsol developer tersebut. Model izin ini mencakup seluruh siklus proses tugas, misalnya mengelola kiriman dan nilai siswa, tidak dapat diakses untuk item CourseWork ini.

Sinkronkan tugas secara otomatis

Dengan notifikasi push Pub/Sub, aplikasi Anda dapat berlangganan notifikasi yang memicu peristiwa saat ada perubahan pada item CourseWork dan kiriman siswa terkait. Dengan demikian, aplikasi Anda dapat menyinkronkan tugas secara mudah dengan tidak perlu melakukan pemeriksaan berkelanjutan untuk melihat apakah konten telah diperbarui di Classroom.

Menyelesaikan & mengirimkan tugas

Setiap tugas dikaitkan dengan N kiriman siswa, dengan N adalah jumlah siswa yang menerima tugas. Dengan kata lain, untuk setiap tugas, ada kiriman siswa yang terkait untuk setiap siswa - yang dapat diakses dengan ID unik. Kiriman siswa ini secara otomatis dibuat dan dapat diambil oleh aplikasi Anda dengan endpoint GET dan LIST yang dikirimkan siswa.

Tombol berbagi dan CourseWork API mendukung penambahan link atau file ke tugas yang dikirimkan siswa. Tombol berbagi memungkinkan hal ini melalui alur kerja yang serupa dengan dialog pembuatan tugas pengajar, dan CourseWork API melalui endpoint studentSubmissions.modifyAttachments. Namun, karena pembatasan izin API yang dijelaskan sebelumnya, fungsi ini terbatas pada item CourseWork yang dibuat aplikasi Anda. Batasan yang sama ini tidak berlaku untuk tombol bagikan — siswa dapat menambahkan tugas mereka ke tugas apa pun yang dipilih dari Classroom.

Mengakhiri alur kerja siswa

Meskipun pembatasan izin CourseWork tidak melayani kasus penggunaan untuk platform yang tidak mendukung pembuatan tugas, salah satu manfaatnya adalah platform pihak ketiga dapat mencegah siswa mengirimkan tugas yang salah dan lupa menyerahkan tugas karena hanya tombol bagikan yang tidak memungkinkan siswa menyerahkan tugas.

Mulai November 2019, tombol bagikan memang menawarkan kemampuan untuk menentukan kursus mana yang akan ditambahi lampiran oleh siswa, tetapi masih tidak mendukung pemilihan tugas secara otomatis. Pertimbangkan risiko siswa mengirimkan tugas yang salah.

Meninjau & menilai tugas

Bagian terakhir dari siklus proses tugas adalah kembali ke pengajar. Setelah siswa berhasil menyerahkan tugas, pengajar kini dapat meninjau tugas dengan cara apa pun yang paling sesuai. Dalam kasus file yang disimpan di Drive, mereka dapat meninjaunya langsung di pemberi nilai Classroom. Namun, aplikasi pihak ketiga tidak dapat diakses di pemberi nilai Classroom. Implikasi dari pengalaman ini adalah pengajar harus membuka beberapa tab saat meninjau dan menilai tugas.

Tombol bagikan saat ini tidak menawarkan solusi untuk penilaian dan pengembalian tugas. Meskipun fitur seperti komentar kiriman siswa saat ini tidak ditampilkan melalui API, penilaian dan pengembalian nilai tersebut dapat dilakukan melalui endpoint studentSubmissions.patch dan studentSubmissions.return. Nilai dapat ditentukan hanya untuk item aliran CourseWork (jenis Tugas dan Pertanyaan). Tugas hanya tersedia dalam bentuk numerik dan dapat ditetapkan sebagai draf atau nilai akhir.

Untuk mengembalikan atau menilai tugas, tugas yang dikirimkan siswa harus diserahkan terlebih dahulu. Saat ini, ada ketidakcocokan antara cara kerja UI Classroom dan API.

Ringkasan perbedaan

Untuk meringkas semua yang telah ditinjau di bagian sebelumnya, tabel di bawah menunjukkan perbandingan berdampingan antara tombol bagikan dan CourseWork API untuk empat kategori yang dibahas di atas: penerapan, membuat dan membagikan tugas, menyelesaikan dan mengirimkan tugas, serta meninjau dan menilai tugas.

	Tombol Bagikan	API CourseWork
Penerapan	Hanya beberapa baris JavaScript, yang menjadikan penerapan mudah dan cepat	Memerlukan penyiapan kunci API, mengaktifkan API di konsol admin, dan pemantauan yang lebih ketat
Membuat dan Membagikan Tugas	Mengalihkan pengajar ke dialog berbagi tombol berbagi Classroom Pengguna dapat memposting semua kecuali satu jenis item streaming Lebih sedikit kolom yang dapat ditentukan Satu memungkinkan pembuatan tugas, tidak ada kemampuan untuk menarik atau mengubah data tugas	Tidak perlu dialog tombol berbagi Sebagian besar kolom tugas Classroom dapat ditentukan Kemampuan untuk mengubah tugas mata pelajaran yang dibuat oleh aplikasi Anda Mengizinkan aplikasi Anda menarik semua data tugas dari Classroom
Menyelesaikan dan Mengirimkan Tugas	Mengalihkan siswa ke dialog berbagi tombol berbagi Classroom Memungkinkan siswa melampirkan kiriman mereka ke tugas Classroom apa pun Satu memungkinkan lampiran kiriman, tidak ada kemampuan untuk menarik atau mengubah data kiriman Tidak mengizinkan siswa menyerahkan tugas	Tidak perlu dialog tombol berbagi Hanya izinkan siswa untuk melampirkan kiriman mereka ke tugas yang dibuat oleh aplikasi Anda Mengizinkan aplikasi Anda mengubah kiriman siswa yang dibuat oleh aplikasi Anda Memungkinkan siswa menyerahkan tugasnya
Meninjau dan Menilai Tugas	Tidak ada dukungan untuk menentukan atau mengembalikan nilai	Mengizinkan aplikasi Anda mengambil semua data kiriman siswa dari Classroom atas nama pengajar Menunjukkan kemampuan untuk memberikan nilai siswa, baik sebagai draf atau nilai akhir Mengekspos kemampuan untuk mengubah nilai siswa Mengekspos kemampuan untuk mengembalikan nilai kepada siswa