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şimde bulunmasını 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 olası eklenti seçeneklerini de içeren bir ödev oluşturmayı gösteren 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. Alakalı iframe sorgu parametreleri, lansman 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.
- Öğretmen, son seçimini yapmadan önce iframe içindeki bir eki ö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'in içinden yeni eklenebilir bir öğe oluşturma özelliği 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.
- Lisans düzeyindeki kısıtlamalar nedeniyle öğretmenin erişemediği içerikleri gizler veya devre dışı bırakır.