Halaman ini mencantumkan beberapa kesalahpahaman umum dan kasus ekstrem yang mungkin ingin Anda dipertimbangkan dalam merancang dan menerapkan add-on Classroom. Sebaiknya Anda menerapkan alat pengaman dan pengujian yang mencakup kasus ini.
Konsep Google Classroom
Bagian ini menyoroti kasus ekstrem dan konsep yang relevan dengan add-on yang berlaku ke seluruh Google Classroom.
Kursus dan peran pengguna
Kursus adalah unit organisasi pusat yang menghubungkan pengajar ke siswa. Kelas merupakan organisasi tingkat tertinggi dalam API Google Classroom.
Pengguna individu dapat ditambahkan ke kursus sebagai "pengajar" atau "siswa". Pengguna perannya dalam kursus tidak terikat dengan perannya di institusinya. Artinya bahwa anggota siswa sekolah dapat menjadi pengajar di kursus, dan pengajar anggota dapat menjadi mahasiswa dalam pelatihan. Sementara kasus yang paling umum adalah sebuah materi untuk merepresentasikan subjek akademik yang dijadwalkan secara rutin, kursus juga dibuat untuk mengatur klub siswa atau melakukan pengembangan profesi.
Hal berikut berlaku untuk semua kursus dalam Google Classroom.
Mengenai pengajar kursus:
- Satu kursus dapat memiliki lebih dari satu pengajar.
- Pengajar dapat ditambahkan ke kursus kapan saja.
- Pengajar dapat dikeluarkan dari kursus kapan saja.
Streaming item
Item streaming adalah konten yang diposting dan dibagikan kepada anggota Kursus. Developer dan pengajar dapat membuat lampiran add-on pada tiga item forum jenis: pengumuman, tugas, dan materi.
Pengajar membuat pengumuman di bagian atas halaman Forum pada UI Classroom. Pengajar membuat tugas dan materi dengan klik tombol Buat di tab Tugas Kelas. Developer dapat membuatnya secara terprogram melalui Classroom API.
Tugas adalah item forum yang dapat menerima kiriman siswa. Tugas adalah satu-satunya jenis item aliran yang muncul di buku nilai yang dapat berisi lampiran add-on.
Mengenai item streaming:
- Tugas atau materi dapat ditugaskan ke sebagian siswa di materi sebelumnya.
- Tugas dapat dinilai atau tidak dinilai. Pengajar dapat mengubah penilaian status tugas kapan saja.
- Tugas dapat memiliki lebih dari satu lampiran.
- Tugas mungkin memiliki jenis lampiran yang berbeda. Misalnya, satu tugas mungkin memiliki Google Dokumen, video YouTube, dan lampiran add-on secara bersamaan.
- Tugas mungkin memiliki lampiran add-on dari lebih dari satu developer.
- Developer bisa mendapatkan dan mengubah informasi tentang item streaming apa pun dengan salah satu lampiran add-on miliknya.
- Developer dapat menyerahkan, mengklaim kembali, atau mengembalikan tugas yang dikirimkan siswa tugas yang menyertakan salah satu lampiran add-on miliknya.
- Pengembang hanya dapat menetapkan nilai untuk kiriman siswa secara individu di tugas yang mereka buat.
Item aliran data disalin
Pengajar dapat menyalin item forum dengan menyalin mata pelajaran, menggunakan kembali tugas, atau memublikasikan item forum ke beberapa kursus. Baca panduan kami tentang konten salinan untuk memahami cara add-on menangani skenario ini.
Institusi pengguna
Google Classroom API tidak menampilkan ID untuk institusi pengguna, build, atau keanggotaan lain di atas level kursus.