Melihat, membuat, dan memodifikasi Tugas Kelas di Classroom
Apa yang dapat saya buat dengan endpoint CourseWork di Classroom API?
Endpoint baru memungkinkan developer melihat dan mengelola tugas di kelas. Secara khusus, Anda bisa Anda dapat melakukan semua hal berikut:
- Melihat tugas dan pertanyaan (secara kolektif disebut sebagai
CourseWork) untuk pengguna - Membuat, mengubah, dan menghapus
CourseWork - Lampirkan materi (file Drive, video YouTube, link) ke
CourseWork - Mengubah status tugas yang dikirimkan siswa (seperti menyerahkan, mengembalikan, mengklaim kembali)
- Menetapkan nilai pengiriman tugas
- Lampirkan 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, menghilangkan data manual antar jemput
- Aplikasi pembelajaran dapat membuat tugas baru yang muncul di kelas feed Anda. Saat siswa menyelesaikan tugas, aplikasi dapat menyerahkan tugas, menyetel memberi nilai, melampirkan tugas siswa, dan menyimpan tugas dengan Folder Drive.
- Pengguna pengajar dapat membuat tugas dengan lampiran add-on dari situs web atau aplikasi Anda.
- Pengguna siswa dapat menyerahkan tugas mereka yang memiliki add-on Anda lampiran.
Izin apa yang diperlukan aplikasi saya untuk membuat atau mengubah tugas?
Biasanya, aplikasi hanya dapat memodifikasi pekerjaan yang dibuatnya. Dengan kata lain, {i>SUMIF<i} memiliki daftar sel permintaan API mutasi penetapan harus menggunakan project ID Google Cloud yang sama disimpan pada waktu pembuatan tugas.
Add-on Google Classroom memiliki pengecualian untuk aturan ini. J Project cloud dapat mengakses atau memodifikasi pengumuman, tugas, atau materi yang memiliki satu atau beberapa lampiran {i>add-on<i}-nya. J 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. Pengajar dapat melihat
tugas, membuat tugas, melampirkan tautan ke pengumpulan tugas, dan
nilai kiriman. Siswa dapat melihat tugas dan melampirkan link ke tugas mereka
catatan tugas, dan menyerahkan
dan mengklaim kembali kiriman mereka. Domain
administrator dapat melihat CourseWork, tetapi tidak memiliki izin tulis.
Jenis item apa yang dapat dilampirkan dalam permohonan saya ke tugas atau kiriman?
API ini mendukung pelampiran file Drive, video YouTube, dan penautan. Penambahan 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 aplikasi yang membuat tugas, 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. Untuk mengubah tugas, permintaan harus menggunakan file Google Cloud yang sama project yang membuat tugas.
Dapatkah saya menjawab pertanyaan terkait API ini?
Belum. Anda dapat membuat dan mengubah pertanyaan. Menjawab pertanyaan secara terprogram ada dalam peta jalan kami.
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 proyek yang 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 project Google Cloud tunggal.
Namun, Anda dapat memaketkan add-on. Hal itu memungkinkan satu Listingan Google Workspace Marketplace untuk mewakili beberapa add-on. Menginstal dari listingan tersebut akan menginstal semua add-on dalam paket dengan sekali. Pengguna harus menyetujui semua cakupan yang diperlukan oleh paket add-on 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 dari 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 pas dalam kotak kecil. Apa pilihan ukuran logo di bilah judul iframe?
Bilah judul iframe dirancang agar hanya mendukung logo persegi 32x32. Ini dibuat agar sesuai dengan bentuk favicon yang digunakan perusahaan di situsnya dan merupakan panduan kami untuk menggunakan logo yang sama dalam ruang demi konsistensi merek.
Domain
Apakah semua pengajar dan siswa di domain yang sama memiliki akses ke add-on yang terinstal?
Administrator Sekolah memiliki kemampuan untuk mengontrol guru mana yang dapat melihat add-on terpasang. Add-on Classroom hanya dapat digunakan oleh pengguna dengan Pengajar Learning atau lisensi Education Plus.
Bagaimana 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 penginstalan administrator . Jika add-on Anda dapat diinstal satu per satu, perhatikan bahwa sebagian besar Administrator mengelola daftar add-on yang diizinkan; guru dapat menginstal add-on untuk mereka sendiri yang ada di daftar ini. Administrator juga dapat memilih untuk instal add-on Anda satu per satu untuk tujuan pengujian.
Administrator juga mungkin tertarik dengan statistik penggunaan mengenai {i>add-on<i}. Jika didukung oleh produk Anda, pertimbangkan untuk menyediakan statistik penggunaan add-on dalam tampilan administrator di situs Anda sendiri.
API
Apa cara yang dapat diandalkan untuk mengetahui apakah halaman partner dimuat di dalam tab iframe atau popout?
Saat ini tidak ada metode untuk membedakan keduanya.
Item tugas mana yang dapat ditugaskan yang mendapatkan iframe Ulasan Tugas Siswa?
iframe Ulasan Tugas Siswa hanya disediakan untuk lampiran jenis aktivitas.
Panggil metode courses.courseWork.getAddOnContext untuk mengetahui apakah postingan
jenis yang mendukung tugas siswa. Kolom supportsStudentWork hanya boleh 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 salah satu lampiran add-on Anda.
Anda dapat reclaim, return, atau turnIn CourseWork StudentSubmission.
{i>Single Sign-On<i}
Dapatkah siswa yang menggunakan badge Clever atau Classlink untuk login ke Chromebook mereka menggunakan login dengan Google?
Ya, mereka tetap dapat menggunakan Login dengan Google.
Apakah setiap siswa memiliki alamat email dengan format yang benar, meskipun mereka tidak memiliki akses Gmail?
Setiap pengguna Google Workspace for Education memiliki identitas Google, terlepas dari apakah mereka memiliki akses ke Gmail. Identitas diwakili oleh email alamat IPv6 Identitas dan akses ke Layanan Google tertentu (termasuk Gmail) berbeda. Jadi, meskipun Gmail dinonaktifkan, pengguna siswa dapat login dengan alamat emailnya.
Apakah administrator sekolah perlu menyetujui aplikasi terlebih dahulu untuk mengizinkan siswa login?
Administrator domain harus mengizinkan add-on sebelum dapat diinstal. Selain itu, administrator domain dapat memasang add-on untuk semua pengguna dalam domain atau unit organisasi.
Masukan dan pertanyaan umum
Bagaimana cara mengirimkan permintaan fitur atau meminta masalah?
Anda dapat mengirim, melihat, dan memberi suara untuk permintaan fitur di masalah publik kami pelacak.
Bagaimana cara mengetahui kapan fitur baru tersedia di Classroom API?
Update untuk 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.