Pertanyaan Umum (FAQ)

Melihat, membuat, dan mengubah Tugas Kelas di Classroom

Apa yang dapat saya buat dengan endpoint Tugas Kelas 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 kolektif 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, klaim kembali).
  • Menetapkan nilai untuk pengiriman tugas.
  • Melampirkan materi (file Drive, video YouTube, link) ke pengiriman 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 melakukan transfer 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 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, setiap 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 apa pun yang memiliki satu atau beberapa lampiran add-on-nya. Project Cloud juga dapat menyerahkan, mengklaim kembali, atau mengembalikan tugas yang memiliki satu atau beberapa lampiran add-on-nya.

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

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

API ini mendukung pelampiran file Drive, video YouTube, dan link. Pelampiran 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 tersebut. Pengguna dapat melaporkan tugas yang dibuat secara eksternal sebagai tugas yang tidak diinginkan, serta memutuskan koneksi aplikasi yang membuat tugas tersebut dengan mencabut kredensial apa pun yang dikeluarkan untuk aplikasi tersebut oleh pengguna.

Tombol berbagi Classroom dan integrasi lainnya

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

Belum. Untuk mengubah tugas, permintaan harus menggunakan project Google Cloud yang sama dengan yang membuat tugas tersebut.

Dapatkah saya menjawab pertanyaan di API?

Belum. 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, Anda dapat menggabungkan add-on. 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 gabungan 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 sesuai dengan persegi kecil, ukuran apa saja yang tersedia untuk logo di kolom judul iframe add-on Classroom?

Kolom judul iframe didesain 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 mana yang dapat melihat add-on yang diinstal. Add-on Classroom hanya dapat digunakan oleh pengguna dengan lisensi Teaching &Learning atau Education Plus.

Bagaimana 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 secara individual, perhatikan bahwa sebagian besar administrator memiliki 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 secara individual untuk tujuan pengujian.

Administrator mungkin juga 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

Apa cara yang dapat diandalkan untuk mengetahui apakah konten add-on dimuat di dalam iframe atau tab baru?

Saat ini tidak ada metode untuk membedakan keduanya.

Item tugas yang dapat ditetapkan mana yang mendapatkan iframe Tinjauan Tugas Siswa?

Iframe Tinjauan Tugas Siswa hanya disediakan untuk lampiran jenis aktivitas. Panggil metode courses.courseWork.getAddOnContextuntuk mengetahui apakah jenis postingan mendukung tugas siswa. Kolom supportsStudentWork hanya dapat bernilai true untuk jenis postingan yang merupakan aktivitas.

Dapatkah lampiran add-on mengakses item forum yang dilampirkan?

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

Single Sign-On

Ya, mereka tetap dapat menggunakan Login dengan Google.

Apakah setiap siswa memiliki alamat email yang diformat 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 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 email mereka, 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 memberikan suara pada permintaan fitur di public issue tracker kami.

Bagaimana cara mengetahui kapan fitur baru tersedia di Classroom API?

Update pada 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.