Pertimbangan utama

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

Konsep Google Classroom

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

Kursus dan peran pengguna

Materi adalah unit organisasi pusat yang menghubungkan pengajar dengan 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 terkait dengan peran mereka di institusi. Artinya, anggota siswa di sekolah dapat menjadi pengajar dalam kursus, dan anggota pengajar dapat menjadi siswa dalam kursus. Meskipun kasus yang paling umum adalah kursus mewakili mata pelajaran akademik yang dijadwalkan secara rutin, kursus juga dibuat untuk mengatur klub siswa atau melakukan pengembangan profesional.

Hal-hal berikut berlaku untuk semua kursus dalam Google Classroom.

Mengenai pengajar kursus:

  • Kursus dapat memiliki lebih dari satu pengajar.
  • Pengajar dapat ditambahkan ke kursus kapan saja.
  • Pengajar dapat dihapus dari kursus kapan saja.

Item streaming

Item streaming adalah bagian dari konten yang diposting dan dibagikan kepada anggota Kursus. Developer dan pengajar dapat membuat lampiran add-on pada tiga jenis item forum: pengumuman, tugas, dan materi.

Guru 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 aliran 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 diberikan kepada sebagian siswa dalam kursus.
  • Tugas dapat dinilai atau tidak dinilai. Pengajar dapat mengubah status penilaian tugas kapan saja.
  • Tugas dapat memiliki lebih dari satu lampiran.
  • Tugas dapat memiliki lampiran dengan berbagai jenis. Misalnya, satu tugas mungkin memiliki lampiran Google Dokumen, video YouTube, dan add-on secara bersamaan.
  • Tugas mungkin memiliki lampiran add-on dari lebih dari satu developer.
  • Developer dapat mendapatkan dan mengubah informasi tentang item forum apa pun dengan salah satu lampiran add-on mereka.
  • Developer dapat menyerahkan, mengklaim kembali, atau mengembalikan tugas siswa untuk tugas yang menyertakan salah satu lampiran add-on mereka.
  • Developer hanya dapat menetapkan nilai untuk setiap pengiriman siswa dalam tugas yang mereka buat.

Item streaming yang disalin

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

Institusi pengguna

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