Pengantar

Tugas di Classroom disebut item CourseWork, yang dapat ditemukan di halaman Tugas Kelas pada 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 kami.

Google Classroom memiliki dua cara untuk berintegrasi dengan alur kerja tugas: Tombol berbagi Classroom dan Classroom API. Tombol bagikan memungkinkan pengguna membagikan konten sebagai item forum apa pun melalui dialog pop-up Classroom, sedangkan Classroom API memungkinkan alur kerja tugas dari awal hingga akhir yang mencakup pembuatan tugas, pembuatan dan pengelolaan kiriman siswa, serta pengembalian nilai.

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

Memahami siklus proses tugas

Sebelum membahas perbedaan antara tombol bagikan dan CourseWork API, mari kita definisikan terlebih dahulu apa yang kita anggap sebagai 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 mengintegrasikan tugas Classroom:

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

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

Penerapan

Perbedaan pertama antara tombol bagikan dan CourseWork API adalah penerapan. Dari perspektif developer, tombol berbagi adalah metode yang lebih mudah untuk membagikan konten ke Classroom karena hanya memerlukan penyertaan resource JavaScript yang diperlukan dan penambahan tag tombol berbagi. Dalam bentuk 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 berintegrasi dengan Tombol Bagikan di sini.

Sebaliknya, CourseWork API adalah bagian dari Google Classroom API REST API, yang memerlukan penyiapan dan pengaktifan kunci API dengan konsol Google Cloud dan mengikuti praktik terbaik untuk berintegrasi dengan API. Hal ini tidak terlalu menjadi masalah jika platform Anda sudah memanfaatkan fungsi Classroom API lainnya, seperti pendaftaran siswa.

Membuat & membagikan tugas

Meskipun tombol bagikan dan CourseWork API memungkinkan 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 dasarnya, kedua solusi ini memungkinkan kemampuan untuk memposting link atau file sebagai tugas ke Classroom. Hal ini berfungsi sebagai alur kerja yang efektif bagi pengajar yang sebaliknya harus 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 Anda memerlukan fleksibilitas untuk memposting konten ini sebagai jenis Classwork lainnya, atau bahkan pengumuman.

Kedua penawaran ini mengekspos semua jenis postingan Classroom kecuali Tugas Kuis. Ringkasan semua jenis postingan dan apakah postingan tersebut ditampilkan dapat dilihat di bawah.

Jenis Postingan	Tombol berbagi	CourseWork API
Pemindahan Hak	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 bagikan memungkinkan pengguna menetapkan kolom seperti tanggal jatuh tempo, topik, mode individual, dan jumlah poin dalam dialog pop-up, kolom tersebut tidak dapat ditetapkan secara terprogram oleh aplikasi pihak ketiga. Namun, API ini mengekspos semua kolom tersebut untuk akses baca dan tulis.

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

Mengubah tugas

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

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

Menyinkronkan 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. Hal ini memungkinkan aplikasi Anda menyinkronkan tugas dengan mudah dengan menghilangkan kebutuhan untuk terus memeriksa apakah konten telah diperbarui di Classroom.

Menyelesaikan & mengirimkan tugas

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

Tombol bagikan dan CourseWork API mendukung penambahan link atau file ke kiriman siswa untuk tugas. Tombol bagikan 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 oleh aplikasi Anda. Pembatasan yang sama ini tidak berlaku untuk tombol bagikan — siswa dapat menambahkan tugas mereka ke tugas apa pun yang mereka pilih dari Classroom.

Mengakhiri alur kerja siswa

Meskipun pembatasan izin CourseWork tidak memiliki 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 mereka karena hanya tombol bagikan yang dibatasi agar siswa tidak dapat menyerahkan tugas mereka.

Mulai November 2019, tombol bagikan menawarkan kemampuan untuk menentukan kursus tempat siswa menambahkan lampiran, tetapi tombol tersebut masih tidak mendukung pemilihan tugas secara otomatis. Pertimbangkan risiko siswa mengirimkan tugas ke tugas yang salah.

Meninjau & menilai tugas

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

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

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

Ringkasan perbedaan

Untuk merangkum 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, pembuatan dan pembagian tugas, penyelesaian dan pengiriman tugas, serta peninjauan dan penilaian tugas.

	Tombol Bagikan	CourseWork API
Penerapan	Hanya beberapa baris JavaScript, sehingga penerapan menjadi mudah dan cepat	Memerlukan penyiapan kunci API, pengaktifan API di konsol admin, dan pemantauan yang lebih cermat
Membuat dan Membagikan Tugas	Mengarahkan pengajar ke dialog berbagi tombol berbagi Classroom Pengguna dapat memposting semua jenis item feed kecuali satu jenis Lebih sedikit kolom yang dapat ditentukan Salah satunya memungkinkan pembuatan tugas, tetapi tidak dapat menarik atau mengubah data tugas	Dialog tombol bagikan tidak diperlukan Sebagian besar kolom tugas Classroom dapat ditentukan Kemampuan untuk mengubah materi kursus yang dibuat oleh aplikasi Anda Memungkinkan aplikasi Anda menarik semua data tugas dari Classroom
Menyelesaikan dan Mengirimkan Tugas	Mengarahkan siswa ke dialog berbagi tombol berbagi Classroom Memungkinkan siswa melampirkan kiriman mereka ke tugas Classroom apa pun Memungkinkan lampiran pengiriman, tidak dapat menarik atau mengubah data pengiriman Tidak mengizinkan siswa menyerahkan tugas	Dialog tombol bagikan tidak diperlukan Hanya mengizinkan siswa melampirkan kiriman mereka ke tugas yang dibuat oleh aplikasi Anda Mengizinkan aplikasi Anda mengubah kiriman siswa yang dibuat oleh aplikasi Anda Memungkinkan siswa menyerahkan tugas mereka
Meninjau dan Menilai Tugas	Tidak ada dukungan untuk menentukan atau mengembalikan nilai	Memungkinkan aplikasi Anda menarik semua data kiriman siswa dari Classroom atas nama pengajar Mengekspos kemampuan untuk menetapkan nilai siswa, baik sebagai draf maupun final Mengekspos kemampuan untuk mengubah nilai siswa Mengekspos kemampuan untuk mengembalikan nilai kepada siswa