Add-on Google Classroom kini tersedia secara umum untuk developer. Lihat dokumentasi add-on untuk informasi selengkapnya.

Halaman ini diterjemahkan oleh Cloud Translation API.

Konten yang disalin di Classroom

Pengajar memiliki kemampuan untuk menyalin tugas di Classroom. Tindakan ini juga akan menyalin lampiran add-on yang terdapat dalam tugas. Hal ini menghemat banyak waktu pengajar saat membuat tugas untuk beberapa bagian atau untuk bagian baru setiap tahun ajaran.

Saat pengajar menyalin tugas di Classroom, tugas yang disalin memiliki parameter kueri courseId, itemId, dan attachmentId yang berbeda dibandingkan dengan tugas aslinya.

Cara menyalin konten

Bagian berikut menjelaskan cara pengajar menyalin tugas di Classroom.

Menyalin kursus

Saat menyalin kursus, semua tugas dalam kursus tersebut akan disalin ke kursus baru sebagai draf. Pengajar kemudian dapat memublikasikan tugas ke siswa yang terdaftar dalam kursus baru. Siswa dapat terdaftar di kursus asli dan kursus yang disalin. Hal ini dapat terjadi jika siswa ditahan atau mengulang kelas.

Gambar 1. Pengajar dapat menyalin kursus dengan membuka menu titik-titik vertikal di Classroom dan mengklik Salin. Kemudian, pengajar dapat menentukan detail mata pelajaran di jendela pop-up dan menyalinnya.

Memublikasikan tugas ke beberapa kursus

Pengajar dapat memublikasikan tugas ke lebih dari satu kursus melalui halaman pembuatan tugas. Ada kemungkinan siswa terdaftar di kedua kursus.

Gambar 2. Pengajar dapat memublikasikan tugas ke lebih dari satu kursus dengan mengklik drop-down di sidebar halaman pembuatan tugas dan memilih beberapa mata pelajaran.

Menggunakan kembali pos

Pengajar dapat menggunakan kembali postingan dengan membuka tab Tugas Kelas dan mengklik Buat. Dari menu drop-down, siswa dapat mengklik Gunakan kembali postingan untuk memilih kelas, lalu memilih tugas yang akan digunakan kembali.

Gambar 3. Pengajar dapat memulai alur penggunaan kembali postingan dari tab Tugas Kelas dan mengklik Gunakan kembali postingan.

Gambar 4. Setelah mengklik Gunakan kembali postingan, pengajar dapat memilih kelas dan tugas yang ingin mereka gunakan kembali.

Perilaku yang diharapkan

Jika kursus atau tugas disalin, siswa yang sama dapat diberi lampiran add-on yang sama di berbagai kursus. Perilaku yang direkomendasikan untuk add-on dalam penetapan yang disalin harus:

Pastikan pengajar masih dapat melihat pratinjau lampiran di teacherViewUri. Jika add-on Anda memerlukan pemberian lisensi dan pengajar belum menyiapkan salinan kursus dengan benar, tampilkan pesan yang mudah digunakan yang memberi tahu pengajar tentang tindakan yang tepat. Setidaknya, pengajar tidak boleh melihat halaman error dalam iframe.
Pastikan siswa melihat lampiran add-on baru di studentViewUri. Untuk lampiran jenis aktivitas, hal ini berarti lampiran tersebut tidak lengkap dan siswa tidak seharusnya dapat melihat respons mereka dari kursus lain. Jika add-on Anda tidak mengizinkan siswa yang sama untuk menyelesaikan lampiran dua kali, tampilkan pesan yang mudah digunakan yang menjelaskan skenario atau jalur untuk menyelesaikan masalah tersebut. Untuk lampiran jenis konten, hal ini berarti menampilkan konten untuk dilihat siswa di studentViewUri. Setidaknya, siswa tidak boleh melihat halaman error di iframe.
Pastikan pengajar melihat kiriman siswa dari tugas yang disalin di studentWorkReviewUri. Pengajar tidak akan dapat melihat kiriman siswa untuk lampiran dari kursus lain. Setidaknya, pengajar tidak boleh melihat halaman error di iframe.

iframe Tampilan Pengajar

Saat pengajar meluncurkan teacherViewUri, attachmentId akan dikirim sebagai parameter kueri selain courseId, itemId, itemType, dan login_hint (jika pengguna telah mengizinkan aplikasi Anda). attachmentId dapat digunakan untuk menampilkan lampiran yang benar dalam iframe.

Jika tidak memiliki data parameter kueri di teacherViewUri, Anda dapat menggunakan objek CopyHistory di resource AddOnAttachment untuk mengidentifikasi tugas asli. Kemudian, Anda dapat menampilkan lampiran yang benar di teacherViewUri.

iframe Tampilan Siswa

Saat siswa meluncurkan studentViewUri, attachmentId dikirim sebagai parameter kueri selain courseId, itemId, itemType, dan login_hint (jika pengguna telah mengizinkan aplikasi Anda). Untuk merender studentViewUri saat tugas atau kursus disalin, gunakan dua parameter:

attachmentId, yang dapat diambil dari URL permintaan.
submissionId, yang dapat diambil dengan memanggil metode courseWork.getAddOnContext, courseWorkMaterials.getAddOnContext, atau announcements.getAddOnContext yang sesuai berdasarkan itemType dan membaca objek StudentContext.

attachmentId adalah ID unik untuk lampiran. Namun, submissionId tidak dijamin unik. Oleh karena itu, tugas yang disalin atau digunakan kembali memiliki attachmentId yang berbeda, tetapi submissionId mungkin tetap sama. Saat siswa meluncurkan studentViewUri, Anda dapat menampilkan lampiran dengan mengidentifikasi tugas siswa berdasarkan kunci gabungan attachmentId dan submissionId.

Jika studentViewUri dirender hanya berdasarkan submissionId, Anda berisiko menampilkan tugas yang dikirimkan siswa dari kursus lain karena submissionId tidak dijamin unik.

Seperti yang disebutkan sebelumnya, jika tidak dapat mengidentifikasi attachmentId, Anda dapat menggunakan objek CopyHistory dalam resource AddOnAttachment untuk mengidentifikasi tugas asli dan parameter kuerinya.

iframe Ulasan Tugas Siswa

Saat pengajar meluncurkan studentWorkReviewUri, attachmentId dan submissionId dikirim sebagai parameter kueri selain courseId, itemId, dan itemType. Anda dapat menggunakan parameter kueri ini untuk mengambil resource AddOnAttachment atau resource CopyHistory jika tidak dapat mengidentifikasi attachmentId yang disediakan. Hal ini memungkinkan Anda menelusuri tugas siswa menggunakan kunci gabungan attachmentId dan submissionId.