Strategi penerapan

Halaman ini memberikan ringkasan singkat tentang interaksi utama antara aplikasi web add-on Anda dan API add-on Google Classroom.

Iframe Penemuan Lampiran

iframe Penemuan Lampiran adalah halaman landing untuk pengajar di add-on Anda. Pertimbangkan untuk melakukan tindakan berikut terkait tampilan ini:

  • Tampilkan UI penemuan atau pembuatan konten Anda.

    Secara opsional, tentukan apakah item feed akan menerima respons siswa, karena Anda mungkin ingin mencegah pengajar menambahkan lampiran jenis aktivitas. Periksa nilai parameter kueri itemType yang diteruskan saat iframe add-on dibuka. Hanya jenis courseWork yang menerima respons siswa.

  • Berdasarkan pilihan pengajar, buat satu atau beberapa permintaan create add-on untuk menambahkan lampiran ke tugas.

Iframe lainnya

Iframe Tampilan Siswa, Iframe Tinjauan Tugas Siswa, dan Iframe Tampilan Pengajar semuanya dimaksudkan untuk menampilkan konten kepada pengguna, bukan mengubah tugas Classroom. Pertimbangkan untuk melakukan tindakan berikut terkait tampilan ini:

  • Saat iframe terbuka, dapatkan izin OAuth pengguna, lalu validasikan ID lampiran dan peran mereka.
  • Saat iframe terbuka, buat courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest, atau announcements.GetAddOnContextRequest berdasarkan itemType untuk memvalidasi peran pengguna.
  • Jika pengguna saat ini adalah siswa, kaitkan submissionId dari respons dengan tugas siswa. Hal ini diperlukan untuk meneruskan nilai dan untuk menampilkan tugas siswa kepada pengajar di alat penilaian; submissionIds cocok di seluruh tampilan.
  • Jika attachmentId sudah diketahui oleh add-on, tampilkan UI lampiran yang sesuai.
  • Jika tidak, berarti postingan induk dari lampiran ini dikopi dari postingan atau kursus lain. Gunakan copyHistory untuk mengidentifikasi salinan terbaru yang diketahui add-on dan menyalin setelan darinya untuk membuat model lampiran baru yang sesuai di sisi add-on. Kemudian, tampilkan UI lampiran yang sesuai.