Apakah pengguna Anda menggunakan Classroom dengan Google Meet? Lihat panduan memulai Apps Script yang membahas cara memeriksa kehadiran siswa di kursus Google Meet.

Halaman ini diterjemahkan oleh Cloud Translation API.

Pertanyaan Umum (FAQ)

Melihat, membuat, dan mengubah CourseWork di Classroom

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

Endpoint baru memungkinkan developer melihat dan mengelola tugas di class. Secara khusus, Anda dapat melakukan semua tindakan 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 kiriman siswa (seperti menyerahkan, mengembalikan, mengklaim kembali)
Menetapkan nilai untuk pengiriman tugas
Melampirkan materi (file Drive, video YouTube, link) ke tugas yang dikirimkan siswa

Beberapa contoh kasus penggunaan CourseWork:

Buku nilai, SIS, atau sistem pelaporan dapat menyinkronkan tugas dan nilai dari Classroom ke aplikasi, sehingga menghilangkan transfer data manual
Aplikasi pembelajaran dapat membuat tugas baru yang muncul di aliran 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 mereka yang memiliki lampiran add-on Anda.

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

Biasanya, aplikasi hanya dapat memodifikasi karya yang dibuatnya. Dengan kata lain, setiap permintaan API mutasi tugas 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 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-onnya.

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

Jenis item apa saja yang dapat dilampirkan ke tugas atau pengumpulan tugas oleh aplikasi saya?

API ini mendukung lampiran file Drive, video YouTube, dan link. Lampiran 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 pekerjaan yang dibuat secara eksternal sebagai tidak diinginkan, serta memutuskan sambungan aplikasi yang membuat pekerjaan tersebut, dengan mencabut kredensial apa pun yang diberikan untuk aplikasi oleh pengguna.

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

Dapatkah saya menjawab pertanyaan di API?

Belum bisa. Anda dapat membuat dan mengubah pertanyaan. Menjawab pertanyaan secara terprogram ada dalam rencana kami.

Add-on Classroom

Konfigurasi Project

Dapatkah saya mengonversi project Google Cloud pribadi yang digunakan 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 GWM?

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

Namun, Anda dapat menggabungkan add-on. Dengan begitu, satu listingan GWM dapat mewakili beberapa add-on. Menginstal dari listingan tersebut kemudian akan menginstal semua add-on dalam paket sekaligus. Pengguna harus mengizinkan semua cakupan yang diperlukan oleh add-on yang dipaketkan saat memberi otorisasi.

Ada dua pertimbangan tambahan terkait pemaketan:

Add-on Classroom hanya tersedia untuk pelanggan Teaching & Learning Upgrade atau SKU Education Plus.
API add-on ada dalam versi Akses Awal, dan dibatasi untuk developer yang berpartisipasi dan project Google Cloud. Add-on yang dipaketkan mungkin tidak berfungsi sebagaimana mestinya jika bergantung pada project Google Cloud yang tidak berpartisipasi.

Dapatkah klien OAuth dari project Google Cloud lain 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 di dalam persegi kecil, opsi ukuran apa yang ada untuk logo di bilah judul iframe?

Kolom judul iframe dirancang hanya untuk mendukung logo persegi 32x32. Pilihan ini dibuat untuk mencocokkan bentuk favicon yang digunakan perusahaan di situs mereka dan merupakan panduan kami untuk menggunakan logo yang sama dalam ruang untuk konsistensi merek.

Domain

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

Administrator Sekolah memiliki kemampuan untuk mengontrol pengajar mana yang dapat melihat add-on yang diinstal.

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 opsi penginstalan administrator. Jika add-on dapat diinstal satu per satu, perlu diperhatikan bahwa sebagian besar Administrator memiliki daftar add-on yang diizinkan; pengajar dapat menginstal add-on sendiri yang ada dalam daftar ini. Administrator juga dapat memilih untuk menginstal add-on 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 popout?

Saat ini tidak ada metode untuk membedakan keduanya.

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

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

Apakah ada perubahan yang dapat menyebabkan gangguan pada API selama program akses awal?

API add-on masih dalam pengembangan. Oleh karena itu, mungkin ada perubahan yang dapat menyebabkan gangguan pada API yang menyebabkan permintaan yang sebelumnya berhasil gagal atau berperilaku secara berbeda. Anda dapat diberi tahu sebelumnya tentang perubahan yang dapat menyebabkan gangguan melalui forum developer.

Dapatkah lampiran add-on mengakses item streaming yang dilampirkan?

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

Kapan add-on Classroom akan dirilis secara publik?

Add-on Classroom tersedia untuk semua pengguna akhir sejak musim panas 2022. Add-on API diperkirakan akan tersedia secara umum bagi developer pada tahun 2024.

{i>Single Sign-On<i}

Dapatkah siswa yang menggunakan badge Clever atau Classlink untuk login ke Chromebook menggunakan login dengan Google?

Ya, mereka masih 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 diwakili oleh alamat email. Identitas dan akses ke Layanan Google tertentu (termasuk Gmail) berbeda. Jadi, meskipun Gmail dinonaktifkan, pengguna siswa dapat login dengan alamat email mereka.

Apakah administrator sekolah perlu menyetujui aplikasi terlebih dahulu untuk mengizinkan siswa login?

Administrator domain harus memasukkan add-on ke daftar yang diizinkan 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 masalah terkait permintaan?

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