Strategi penerapan

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 jenis courseWork 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, atau announcements.GetAddOnContextRequest berdasarkan itemType 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.