Pertimbangan utama

Halaman ini mencantumkan beberapa kesalahpahaman umum dan kasus ekstrem yang mungkin ingin Anda pertimbangkan dalam mendesain dan menerapkan add-on Classroom. Sebaiknya Anda menerapkan alat pengaman dan pengujian yang mencakup kasus ini.

Konsep Google Classroom

Bagian ini menyoroti kasus dan konsep ekstrem yang relevan dengan add-on yang berlaku untuk semua Google Classroom.

Kursus dan peran pengguna

Kursus adalah unit organisasi pusat yang menghubungkan pengajar ke siswa. Kursus adalah tingkat organisasi tertinggi di Google Classroom API.

Setiap pengguna dapat ditambahkan ke kursus sebagai "pengajar" atau "siswa". Peran pengguna dalam kursus tidak terikat dengan perannya di institusinya. Artinya, anggota siswa sekolah dapat menjadi pengajar dalam kursus, dan anggota pengajar dapat adalah siswa dalam kursus. Meskipun kasus yang paling umum adalah kursus untuk mewakili mata pelajaran akademik yang dijadwalkan secara rutin, kursus juga dibuat untuk mengatur klub siswa atau melakukan pengembangan profesional.

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 jenis item aliran: pengumuman, tugas, dan materi.

Pengajar membuat pengumuman di bagian atas halaman Forum di UI Classroom. Pengajar membuat tugas dan materi dengan mengklik 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 forum yang muncul di buku nilai yang dapat berisi lampiran add-on.

Mengenai item streaming:

  • Tugas atau materi dapat diberikan kepada sebagian siswa dalam kursus tersebut.
  • Tugas dapat dinilai atau tidak dinilai. Pengajar dapat mengubah status penilaian tugas kapan saja.
  • Tugas dapat memiliki lebih dari satu lampiran.
  • Tugas mungkin memiliki jenis lampiran yang berbeda. Misalnya, satu tugas dapat berisi Google Dokumen, video YouTube, dan lampiran add-on secara bersamaan.
  • Tugas mungkin memiliki lampiran add-on dari lebih dari satu developer.
  • Developer dapat memperoleh dan mengubah informasi tentang item forum apa pun dengan salah satu lampiran add-on.
  • Developer dapat menyerahkan, mengklaim kembali, atau mengembalikan tugas yang dikirimkan siswa untuk tugas yang menyertakan salah satu lampiran add-on mereka.
  • Developer hanya dapat menetapkan nilai untuk masing-masing kiriman siswa dalam tugas yang mereka buat.

Item aliran data disalin

Pengajar dapat menyalin item forum dengan menyalin kursus, menggunakan kembali tugas, atau memublikasikan item forum ke beberapa kursus. Baca panduan kami tentang konten salinan untuk memahami cara add-on dapat menangani skenario ini.

Institusi pengguna

Google Classroom API tidak menampilkan ID untuk institusi pengguna, gedung, atau keanggotaan lain di atas level kursus.