Pertanyaan Umum (FAQ)

Melihat, membuat, dan mengubah Tugas di Classroom

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

Endpoint 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 tugas yang dikirimkan siswa (seperti serahkan, pengembalian, klaim kembali)
  • Menetapkan nilai untuk pengiriman tugas
  • Lampirkan 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 menghilangkan transfer data 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 pekerjaan yang dibuatnya. Dengan kata lain, permintaan API mutasi tugas apa pun harus menggunakan project ID Google Cloud yang sama dengan yang disimpan pada waktu pembuatan tugas.

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. Project Cloud juga dapat menyerahkan, 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, dan menyerahkan dan mengklaim kembali kirimannya. 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 lampirkan 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 memutuskan koneksi aplikasi yang membuat pekerjaan, dengan mencabut kredensial apa pun yang dikeluarkan ke aplikasi oleh pengguna.

Tombol berbagi Classroom dan integrasi lainnya

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

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

Dapatkah saya menjawab pertanyaan terkait API ini?

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?

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. Tindakan ini memungkinkan satu listingan Google Workspace Marketplace mewakili beberapa add-on. Menginstal dari listingan tersebut akan menginstal semua add-on dalam paket sekaligus. Pengguna harus mengizinkan semua cakupan yang diperlukan oleh add-on yang dipaketkan 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 dihasilkan oleh project Google Cloud lain ditolak oleh Classroom API. Anda harus membuat klien OAuth terpisah untuk project add-on.

Pengalaman pengguna

Logo kami tidak pas dalam kotak kecil. Apa saja opsi ukuran untuk logo di panel judul iframe?

Bilah judul iframe dirancang agar hanya mendukung logo persegi 32x32. Pilihan ini dibuat agar cocok dengan bentuk favicon yang digunakan perusahaan di situs mereka dan kami merekomendasikan penggunaan logo yang sama di ruang tersebut untuk konsistensi merek.

Domain

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

Administrator Sekolah 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 cara administrator domain berinteraksi dengan add-on?

Administrator domain (Administrator) mengontrol siapa saja yang dapat menggunakan add-on Anda. Mereka dapat menginstal add-on untuk seluruh domain menggunakan opsi penginstalan administrator. Jika add-on dapat diinstal satu per satu, perhatikan bahwa sebagian besar Administrator mempertahankan daftar add-on yang diizinkan; pengajar dapat menginstal add-on sendiri yang tercantum dalam daftar ini. Administrator juga dapat memilih untuk menginstal add-on Anda satu per satu 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 andal untuk mengetahui apakah halaman partner dimuat di dalam iframe atau tab pop-out?

Saat ini tidak ada metode untuk membedakan keduanya.

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

Iframe Ulasan Tugas Siswa hanya disediakan untuk lampiran jenis aktivitas. Panggil metode courses.courseWork.getAddOnContext untuk mengetahui apakah jenis postingan mendukung tugas siswa. Kolom supportsStudentWork hanya boleh true untuk jenis postingan yang merupakan aktivitas.

Dapatkah lampiran add-on mengakses item streaming yang dilampirkan?

Ya. Anda dapat get atau patch Announcement, CourseWork, atau CourseWorkMaterial yang berisi setidaknya salah 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 diwakili oleh alamat email. Identitas dan akses ke Layanan Google tertentu (termasuk Gmail) berbeda. Jadi, meskipun jika Gmail dinonaktifkan, pengguna siswa dapat login dengan alamat email mereka.

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

Administrator domain harus mencantumkan add-on ke daftar yang diizinkan sebelum add-on 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 meminta masalah?

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

Bagaimana cara mengetahui kapan fitur baru tersedia di Classroom API?

Update pada API diposting di halaman catatan rilis, forum developer kami, dan issue tracker publik.

Saya menggunakan Classroom API. Bagaimana cara mengajukan pertanyaan teknis?

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