Pengantar

Tugas di Classroom disebut item Tugas Kursus, 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 berintegrasi dengan alur kerja tugas: tombol berbagi Classroom dan Classroom API. Tombol bagikan memungkinkan pengguna membagikan konten sebagai item forum melalui dialog pop-up Classroom, sedangkan Classroom API memungkinkan alur kerja tugas dari awal hingga akhir yang mencakup pembuatan tugas, pembuatan dan pengelolaan pengiriman siswa, serta penerusan nilai.

Di sini, kita akan meninjau perbedaan utama antara kedua 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 beralih ke perbedaan antara tombol bagikan dan CourseWork API, mari kita tentukan 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 berintegrasi dengan tugas Classroom:

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

Dengan integrasi ke tugas Classroom, pengajar dan siswa dapat 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 bagikan dan CourseWork API adalah implementasi. Dari perspektif developer, tombol bagikan adalah metode yang lebih mudah untuk membagikan konten ke Classroom karena hanya perlu menyertakan resource JavaScript yang diperlukan dan menambahkan tag tombol bagikan. Dalam bentuk tersimple, 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.

Di sisi lain, CourseWork API adalah bagian dari REST API Google Classroom 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 daftar nama.

Membuat & membagikan tugas

Meskipun tombol bagikan 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 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 akan dipaksa untuk menggunakan alur kerja salin dan tempel antara Classroom dan aplikasi pihak ketiga. Meskipun kedua solusi tersebut mendukung kemampuan untuk memposting konten sebagai tugas, Anda harus mempertimbangkan apakah aplikasi Anda memerlukan fleksibilitas untuk memposting konten ini sebagai jenis Tugas lain, atau bahkan pengumuman.

Kedua penawaran ini menampilkan semua jenis postingan Classroom kecuali Tugas Kuis. Ringkasan semua jenis postingan dan apakah postingan tersebut diekspos dapat ditemukan 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 tersebut. Meskipun integrasi tombol bagikan memungkinkan pengguna menetapkan kolom seperti batas waktu, topik, mode individual, dan jumlah poin dalam dialog pop-up, kolom tersebut tidak dapat ditetapkan secara terprogram oleh aplikasi pihak ketiga. Di sisi lain, API mengekspos semua kolom ini untuk akses baca dan tulis.

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

Mengubah tugas

Menghilangkan kebutuhan pengguna untuk menyinkronkan detail tugas mereka yang berubah secara manual adalah salah satu manfaat integrasi 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, penting untuk diperhatikan bahwa item CourseWork yang tidak dibuat oleh konsol developer yang sama tidak dapat diubah oleh konsol developer tersebut. Model izin ini diperluas ke seluruh siklus proses tugas, misalnya mengelola pengiriman dan nilai siswa, tidak dapat diakses untuk item Tugas ini.

Menyinkronkan tugas secara otomatis

Dengan notifikasi push Pub/Sub, aplikasi Anda dapat berlangganan notifikasi yang memicu peristiwa saat terjadi perubahan pada item CourseWork dan kiriman siswa terkait. Hal ini memungkinkan aplikasi Anda menyinkronkan tugas dengan mudah dengan menghilangkan kebutuhan pemeriksaan berkelanjutan untuk melihat 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. Pengiriman tugas siswa ini dibuat secara otomatis dan dapat diambil oleh aplikasi Anda dengan endpoint GET dan LIST pengiriman tugas siswa.

Tombol bagikan dan CourseWork API mendukung penambahan link atau file ke pengiriman 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 aplikasi Anda. Batasan 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 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 mereka karena hanya tombol bagikan yang dibatasi dari kemampuan siswa untuk menyerahkan tugas mereka.

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

Meninjau & menilai tugas

Bagian terakhir dari siklus proses tugas akan 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, mereka dapat meninjau langsung di alat penilaian Classroom. Namun, aplikasi pihak ketiga tidak dapat diakses di pemeriksa Classroom. Implikasi pengalaman ini adalah pengajar harus membuka beberapa tab saat meninjau dan menilai tugas.

Tombol bagikan saat ini tidak menawarkan solusi untuk menilai dan menampilkan tugas. Meskipun fitur seperti komentar kiriman tugas siswa saat ini tidak ditampilkan melalui API, penilaian dan pengembalian nilai tersebut kepada siswa dapat dilakukan melalui endpoint studentSubmissions.patch dan studentSubmissions.return. Nilai hanya dapat ditentukan untuk item aliran Tugas (jenis Tugas dan Pertanyaan). Nilai ini hanya tersedia dalam bentuk numerik dan dapat ditetapkan sebagai nilai 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 dan API Classroom.

Ringkasan perbedaan

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

	Tombol Bagikan	CourseWork API
Penerapan	Hanya beberapa baris JavaScript, sehingga penerapannya mudah dan cepat	Memerlukan penyiapan kunci API, pengaktifan API di konsol admin, dan pemantauan yang lebih cermat
Membuat dan Membagikan Tugas	Mengalihkan pengajar ke dialog berbagi tombol berbagi Classroom Pengguna dapat memposting semua jenis item streaming kecuali satu Lebih sedikit kolom yang dapat ditentukan Satu izin memungkinkan pembuatan tugas, tidak ada kemampuan untuk mengambil 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 mengambil 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 pengiriman, tidak dapat mengambil 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
Meninjau dan Memberi Nilai Tugas	Tidak ada dukungan untuk menentukan atau menampilkan nilai	Memungkinkan aplikasi Anda mengambil semua data kiriman siswa dari Classroom atas nama pengajar Mengekspos kemampuan untuk menetapkan nilai siswa, baik sebagai draf maupun nilai akhir Mengekspos kemampuan untuk mengubah nilai siswa Mengekspos kemampuan untuk menampilkan nilai kepada siswa