Ekleme Keşfi iframe'i, Classroom ödevi oluşturulurken eklenti açıldığında öğretmene gösterilen ilk görünümdür. Ek, öğrencilerin etkileşime geçmesini istediğiniz içerik veya etkinliktir.
Bir öğretmen, Classroom kursunda yeni bir yayın (ör. ödev, duyuru veya soru) oluşturur ve eklenti açılır listesinden bir eklenti seçer. Classroom, kısa bir süre (yaklaşık birkaç saat) boyunca eklentinin yayına ek eklemesine izin verir.
Şekil 1. Öğretmenin ekleyebileceği eklenti seçeneklerini içeren bir ödev oluşturma görünümü.
Öğretmen bir eklenti seçtikten sonra Classroom, Eklenti Keşfi iframe'i oluşturur ve eklentinin başlatma URL'sini yükler. Alakalı tüm iframe sorgu parametreleri başlatma URL'sine iletilir.
Şekil 2. Bir iFrame'de ek bulma kullanıcı arayüzü örneği.
Öğretmen, bir 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 tamamladığında eklenti, iframe'in kapatılmasını isteyen bir postMessage yükü gönderir.
İçeriği çerçeve kapatır ve öğretmen, önizleyebileceği veya ödevden kaldırabileceği ekleri görebilir.
Şekil 3. Üç etkinlik türü eklenti eki içeren bir ödev oluşturma görünümü.
iFrame içindeki kullanıcı deneyimi ile ilgili dikkat edilmesi gereken noktalar
- Eklenti ilk açıldığında öğretmenden oturum açmasını istemelidir.
- Tüm Classroom API çağrıları için Google tek oturum açma gerekir. Ürününüzün ayrı bir giriş sistemi varsa hesapları bağlamanız gerekir.
- Öğretmenler, nihai seçimlerini yapmadan önce iframe'da ekleri önizleyebilmelidir.
- Öğretmenler, eklenebilir içerikleri arayabilir veya bunlara göz atabilir.
- Eklenti, son içerikler, içeriklerim ve öğrenme becerilerine göre filtreleme gibi çeşitli görünümler sunabilir.
- Eklenti, iframe'den yeni bir eklenebilir öğe oluşturma olanağı sağlamalıdır.
Kullanıcı deneyimi koşulları hakkında daha fazla bilgi için Classroom eklentisi koşullar listesini inceleyin.
İçeriği çerçeve içinde lisanslama durumunu gösterme
Eklenti için lisans gerekiyorsa ve öğretmenin lisansı yoksa öğretmene, durumu düzeltmek için atması gereken uygun adımları açıkça belirten bir mesaj gösterilmelidir. Bu, lisanslama kısıtlamalarından kaynaklanabilecek karışıklıkları önlemek içindir.
Ayrıca eklentinizin:
- Ekleme Keşfi iframe'inde öğretmenin lisanslama düzeyini gösterir.
- Lisanslama düzeyindeki kısıtlamalar nedeniyle öğretmenin erişemediği içerikleri gizler veya devre dışı bırakır.