Strategi penerapan

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

iframe Penemuan Lampiran

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

• Saat iframe Penemuan Lampiran terbuka, buat courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest, atau announcements.GetAddOnContextRequest berdasarkan itemType untuk memvalidasi peran pengguna dan mendapatkan nilai supportsStudentWork.
• Tampilkan UI penemuan atau pembuatan konten. Anda dapat menghapus lampiran jenis aktivitas berdasarkan nilai supportsStudentWork dari respons validasi peluncuran.
• 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 menyajikan konten kepada pengguna, bukan mengubah tugas Classroom. Pertimbangkan untuk melakukan tindakan berikut terkait tampilan ini:

• Saat iframe terbuka, dapatkan izin OAuth pengguna, lalu validasikan peran dan ID lampirannya.

  • 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, postingan induk dari lampiran ini harus disalin dari postingan atau kursus lain. Gunakan copyHistory untuk mengidentifikasi salinan terbaru yang diketahui add-on dan menyalin setelan dari lampiran tersebut untuk membuat model lampiran baru yang sesuai di sisi add-on. Kemudian, tampilkan UI lampiran yang sesuai.
  Penting: Anda mungkin menemukan kasus ekstrem di sini; pengguna pertama yang mengakses lampiran ini mungkin adalah siswa.