Halaman ini menyediakan ringkasan singkat tentang interaksi utama antara aplikasi web add-on dan API add-on Google Classroom.
iframe Penemuan Lampiran
iframe Lampiran Penemuan adalah halaman landing untuk pengajar di add-on Anda. Pertimbangkan untuk mengambil tindakan berikut terkait tampilan ini:
Menampilkan UI penemuan atau pembuatan konten.
Secara opsional, tentukan apakah item forum akan menerima respons siswa, karena Anda mungkin ingin mencegah pengajar menambahkan lampiran jenis aktivitas. Periksa nilai parameter kueri
itemType
yang diteruskan saat add-on iframe dibuka. Hanya jeniscourseWork
yang menerima respons siswa.Berdasarkan pilihan pengajar, buat satu atau beberapa permintaan add-on
create
untuk menambahkan lampiran ke tugas.
iframe lainnya
Iframe Tampilan Siswa, iframe Ulasan Tugas Siswa, dan iframe Tampilan Pengajar semuanya ditujukan 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 validasi peran dan ID lampirannya.
- Saat iframe terbuka, buat
courseWork.GetAddOnContextRequest
,courseWorkMaterials.GetAddOnContextRequest
, atauannouncements.GetAddOnContextRequest
berdasarkanitemType
untuk memvalidasi peran pengguna. - Jika pengguna saat ini adalah siswa, kaitkan
submissionId
dari respons dengan tugas siswa. Tindakan ini diperlukan untuk meneruskan nilai dan 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 pada lampiran ini harus disalin dari postingan atau kursus lain. Gunakan
copyHistory
untuk mengidentifikasi salinan terbaru yang diketahui oleh add-on dan salin setelan dari add-on tersebut untuk membuat model baru lampiran yang sesuai di sisi add-on. Kemudian, tampilkan UI lampiran yang sesuai.