Pertanyaan Umum (FAQ)

Melihat, membuat, dan mengubah CourseWork di Classroom

Apa yang dapat saya bangun dengan endpoint CourseWork di Classroom API?

Endpoint ini memungkinkan developer melihat dan mengelola tugas di kelas. Secara khusus, Anda dapat melakukan semua hal berikut:

  • Melihat tugas dan pertanyaan (secara bersama-sama disebut sebagai CourseWork) untuk pengguna.
  • Membuat, mengubah, dan menghapus CourseWork.
  • Melampirkan materi (file Drive, video YouTube, link) ke CourseWork.
  • Mengubah status pengiriman siswa (seperti serahkan, kembalikan, ambil kembali).
  • Tetapkan nilai untuk pengiriman tugas.
  • Melampirkan materi (file Drive, video YouTube, link) ke kiriman siswa.

Beberapa contoh kasus penggunaan untuk CourseWork:

  • Buku nilai, SIS, atau sistem pelaporan dapat menyinkronkan tugas dan nilai dari Classroom ke aplikasi mereka, sehingga tidak perlu lagi mentransfer data secara manual.
  • Aplikasi pembelajaran dapat membuat tugas baru yang muncul di forum kelas. Saat siswa menyelesaikan tugas, aplikasi dapat menyerahkan tugas, menetapkan nilai, melampirkan tugas siswa, dan menyimpan tugas di folder Drive yang sesuai.
  • Pengguna yang merupakan pengajar dapat membuat tugas dengan lampiran add-on dari situs atau aplikasi Anda.
  • Pengguna siswa dapat menyerahkan tugas yang memiliki lampiran add-on Anda.

Izin apa yang diperlukan aplikasi saya untuk membuat atau mengubah tugas?

Biasanya, aplikasi hanya dapat mengubah tugas yang dibuatnya. Dengan kata lain, semua permintaan API untuk mengubah CourseWork harus menggunakan ID project Google Cloud yang sama dengan yang digunakan untuk membuat CourseWork.

Add-on Google Classroom memiliki pengecualian untuk aturan ini. Project Cloud dapat mengakses atau mengubah pengumuman, tugas, atau materi yang memiliki satu atau beberapa lampiran add-on-nya. Project Cloud juga dapat mengirimkan, mengklaim kembali, atau mengembalikan tugas yang memiliki satu atau beberapa lampiran add-on.

Permintaan API juga memerlukan cakupan pengguna yang benar. Pengajar dapat melihat tugas, membuat tugas, melampirkan link ke kiriman tugas, dan menetapkan nilai kiriman. Siswa dapat melihat tugas, melampirkan link ke catatan tugas mereka, serta mengumpulkan dan mengklaim kembali kiriman mereka. Administrator domain dapat melihat CourseWork, tetapi tidak memiliki izin tulis.

Jenis item apa yang dapat dilampirkan aplikasi saya ke tugas atau kiriman?

API ini mendukung lampiran file Drive, video YouTube, dan link. Melampirkan Google Formulir native belum didukung.

Apakah pengguna akhir mengetahui bahwa tugas di Classroom dibuat oleh aplikasi saya?

Ya. UI Classroom mengidentifikasi tugas yang dibuat secara eksternal menggunakan nama produk project Google Cloud yang membuat tugas. Pengguna dapat melaporkan pekerjaan yang dibuat secara eksternal sebagai tidak diinginkan, serta menghentikan koneksi aplikasi yang membuat pekerjaan tersebut dengan mencabut kredensial apa pun yang dikeluarkan untuk aplikasi oleh pengguna.

Tombol berbagi Classroom dan integrasi lainnya

Saya sudah terintegrasi dengan tombol berbagi Classroom. Dapatkah saya mengubah tugas yang dibuat menggunakan tombol bagikan?

Belum pernah. Untuk mengubah penetapan, permintaan harus menggunakan project Google Cloud yang sama dengan yang membuat penetapan.

Dapatkah saya menjawab pertanyaan di API?

Belum pernah. Anda dapat membuat dan mengubah pertanyaan.

Add-on Classroom

Konfigurasi Project

Dapatkah saya mengonversi project Google Cloud pribadi yang saya gunakan selama pengembangan menjadi project publik yang dapat saya gunakan dalam produksi?

Tidak, Anda tidak dapat mengonversi project Google Cloud pribadi menjadi project publik. Anda memerlukan dua project terpisah, satu untuk pengembangan dan satu lagi untuk produksi.

Dapatkah satu project Google Cloud memiliki dua listingan Google Workspace Marketplace?

Tidak. Anda tidak dapat membuat dua listingan Google Workspace Marketplace untuk satu project Google Cloud.

Namun, add-on dapat dibundel. Dengan begitu, satu listingan Google Workspace Marketplace dapat mewakili beberapa add-on. Penginstalan dari listingan tersebut akan menginstal semua add-on dalam paket sekaligus. Pengguna harus menyetujui semua cakupan yang diperlukan oleh add-on paket saat memberikan otorisasi.

Dapatkah klien OAuth dari project Google Cloud yang berbeda digunakan kembali dengan project Google Cloud untuk add-on Classroom?

Tidak, klien OAuth dari project Google Cloud selain project Google Cloud add-on Classroom tidak dapat berfungsi. Token akses yang dibuat oleh project Google Cloud lain ditolak oleh Classroom API. Anda harus membuat klien OAuth terpisah untuk project add-on.

Pengalaman pengguna

Logo kami tidak cocok dengan kotak kecil, opsi ukuran apa yang tersedia untuk logo di kolom judul iframe add-on Classroom?

Panel judul iframe dirancang untuk hanya mendukung logo persegi 32x32. Pilihan ini dibuat agar sesuai dengan bentuk favicon yang digunakan perusahaan di situs mereka dan kami menyarankan untuk menggunakan logo yang sama di ruang tersebut demi konsistensi merek.

Domain

Apakah semua pengajar dan siswa di domain yang sama memiliki akses ke add-on yang diinstal?

Administrator domain memiliki kemampuan untuk mengontrol pengajar yang dapat melihat add-on yang diinstal. Add-on Classroom hanya dapat digunakan oleh pengguna dengan lisensi Teaching & Learning atau Education Plus.

Bagaimana cara administrator domain berinteraksi dengan add-on?

Administrator domain mengontrol siapa yang dapat menggunakan add-on Anda. Mereka dapat menginstal add-on untuk seluruh domain menggunakan opsi penginstalan administrator. Jika add-on Anda dapat diinstal satu per satu, perhatikan bahwa sebagian besar administrator mengelola daftar yang diizinkan untuk add-on; pengajar yang ada dalam daftar ini dapat menginstal add-on untuk diri mereka sendiri. Administrator juga dapat memilih untuk menginstal add-on Anda satu per satu untuk tujuan pengujian.

Administrator juga mungkin tertarik dengan statistik penggunaan terkait add-on Anda. Jika didukung oleh produk Anda, pertimbangkan untuk memberikan statistik penggunaan add-on dalam tampilan administrator di situs Anda sendiri.

API

Bagaimana cara yang andal untuk mengetahui apakah konten add-on dimuat di dalam iframe atau tab baru?

Saat ini tidak ada metode untuk membedakan keduanya.

Item tugas mana yang mendapatkan iframe Peninjauan Tugas Siswa?

IFrame Peninjauan Hasil Kerja Siswa hanya disediakan untuk lampiran jenis aktivitas. Panggil metode courses.courseWork.getAddOnContext untuk mengetahui apakah jenis postingan mendukung tugas siswa. Kolom supportsStudentWork hanya dapat berupa true untuk jenis postingan yang merupakan aktivitas.

Dapatkah lampiran add-on mengakses item aliran yang dilampirkan?

Ya. Anda dapat get atau patch Announcement, CourseWork, atau CourseWorkMaterial yang berisi setidaknya satu lampiran add-on Anda. Anda dapat reclaim, return, atau turnIn CourseWork StudentSubmission.

Single Sign-On

Ya, mereka tetap dapat menggunakan Login dengan Google.

Apakah setiap siswa memiliki alamat email yang dibuat dengan benar meskipun mereka tidak memiliki akses Gmail?

Setiap pengguna Google Workspace for Education memiliki identitas Google, terlepas dari apakah mereka memiliki akses ke Gmail atau tidak. Identitas dan akses ke setiap Layanan Google tertentu (termasuk Gmail) berbeda. Meskipun Gmail dinonaktifkan, pengguna siswa dapat login ke Classroom dengan alamat email mereka. Identitas diwakili oleh ID pengguna dan alamat email. Pengguna Google Workspace for Education dapat mengubah alamat emailnya, jadi sebaiknya gunakan ID pengguna sebagai kunci utama saat menyimpan informasi pengguna.

Apakah administrator sekolah perlu menyetujui aplikasi terlebih dahulu agar siswa dapat login?

Administrator domain harus mengizinkan add-on sebelum dapat diinstal. Secara opsional, administrator domain dapat menginstal add-on untuk semua pengguna dalam domain atau unit organisasi.

Masukan dan pertanyaan umum

Bagaimana cara mengirimkan permintaan fitur atau melaporkan masalah?

Anda dapat mengirimkan, melihat, dan memberi suara untuk permintaan fitur di issue tracker publik kami.

Bagaimana cara mengetahui kapan fitur baru tersedia di Classroom API?

Update untuk API diposting di newsletter developer dan issue tracker publik.

Saya menggunakan Classroom API. Bagaimana cara mengajukan pertanyaan teknis?

Posting pertanyaan Anda di Stack Overflow dengan tag google-classroom.