Ek Keşfi iframe'i, Classroom görevi oluşturulurken bir eklentiyi açarken öğretmene gösterilen ilk görünümdür. Ek, öğrencilerin etkileşimde bulunmasını istediğiniz içerik veya etkinliktir.
Öğretmen, bir Classroom dersinde yeni bir yayın (örneğin, ödev, duyuru veya soru) oluşturur ve eklenti açılır listesinden bir eklenti seçer. Classroom, kısa bir süre için (saat cinsinden) eklentinin yayına ek eklemesine izin verir.
Şekil 1. Öğretmenin ekleyebileceği olası eklenti seçeneklerini de içeren ödev oluşturma görünümü.
Öğretmen bir eklenti seçtikten sonra Classroom bir Ek Keşfi iframe'i oluşturur ve eklentinin başlatma URL'sini yükler. İlgili tüm iframe sorgu parametreleri başlangıç URL'sine aktarılır.
2. Şekil. Bir iframe'de ek keşfi kullanıcı arayüzü örneği.
Öğretmen, ek seçmek için iş ortağının web uygulamasını bir iframe içinde kullanır. Uygulama, eki ödeve eklemek için Classroom API çağrıları yapar. Öğretmen ekleri seçmeyi bitirdiğinde eklenti, iframe'in kapatılmasını isteyen bir postMessage yükü gönderir.
iframe kapanır ve öğretmen artık önizlemeyi veya ödevden kaldırmayı tercih edebileceği ekleri görebilir.
3. Şekil. Üç etkinlik türü eklenti eki içeren bir ödev oluşturma görünümü.
iframe'de kullanıcı deneyimi ile ilgili dikkat edilmesi gereken noktalar
- Eklenti ilk açılışta öğretmenden oturum açmasını istemelidir.
- Tüm Classroom API çağrıları için Google tek oturum açma gereklidir. Ürününüzde ayrı bir giriş sistemi varsa hesapları bağlamanız gerekir.
- Öğretmen, nihai seçimini yapmadan önce iframe içindeki bir eki önizleyebilmelidir.
- Öğretmen, eklenebilir içerik arayabilmeli veya bu içeriklere göz atabilmelidir.
- Eklenti; son içerikler, içeriğim ve öğrenme becerilerine göre filtreleme gibi çeşitli görünümler sağlayabilir.
- Eklenti, iframe'in içinden yeni bir eklenebilir öğe oluşturabilmelidir.
Kullanıcı deneyimi şartları hakkında daha fazla bilgi için Classroom eklentisi gereksinimler listesini inceleyin.
Lisans durumunu iframe'de göster
Eklenti lisans gerektiriyorsa ve öğretmenin lisansı yoksa öğretmene bu durumu düzeltmesi için atılması gereken uygun adımlar hakkında net bir mesaj sunulmalıdır. Bu uygulamanın amacı, lisanslama kısıtlamalarından doğabilecek karışıklıkları önlemektir.
Eklentiniz için şunları da öneririz:
- Öğretmenin Ek Keşfi iframe'i içinde lisanslama düzeyini gösterir.
- Lisans düzeyindeki kısıtlamalar nedeniyle, bir öğretmenin kullanamadığı içeriği gizler veya devre dışı bırakır.