Sürüm 1.1, 5 Aralık 2024.
Bu sayfadaki ölçütler tüm Classroom eklentileri için geçerlidir. Eklentinizin, Google Workspace Marketplace'te listelenmek ve "Classroom ile çalışır" eklentisi olarak onaylanmak için geçerli olan tüm gerekli öğeleri karşılaması gerekir.
Bu belgedeki "ZORUNLU" ("MUST"), "ZORUNLU DEĞİL" ("MUST NOT"), "GEREKLİ" ("REQUIRED"), "GEREKLİ" ("SHALL"), "GEREKLİ DEĞİL" ("SHALL NOT"), "GEREKLİ" ("SHOULD"), "GEREKLİ DEĞİL" ("SHOULD NOT"), "ÖNERİLİR" ("RECOMMENDED"), "OLABİLİR" ("MAY") ve "İSTEĞE BAĞLI" ("OPTIONAL") anahtar kelimeleri, RFC 2119'da belirtildiği şekilde yorumlanmalıdır.
Şartlar
| Kimlik | Tür | ||
|---|---|---|---|
| 1.0 | Son Kullanıcı Lisansı (varsa) | ||
| 1.1 | Kullanıcı lisansa sahip olmadığında kullanıcıya kullanıcı dostu bir mesaj GÖSTERİLMELİDİR. İleti, eklentinin kullanılamama nedenini net bir şekilde belirtmeli ve kullanıcının durumu düzeltmesi için bir işlem önerisinde bulunmalıdır. | ÖNERİLİR | |
| 1.3 | Eklentinin Google Workspace Marketplace girişinde, eklentinin kullanımı için gerekebilecek lisans ve abonelik şartlarıyla ilgili ayrıntılar BELİRTİLMELİDİR. Eklentinin ücretli katmanı varsa Marketplace girişi, fiyatlandırma veya satış görevlisiyle nasıl iletişime geçileceği hakkında daha fazla bilgi sunan bir web sayfasının bağlantısını İÇERMELİDİR. | ÖNERİLİR | |
| 2.0 | Son kullanıcı oturum açma | ||
| 2.1 | Öğretmen kullanıcılar, Google TOA'yı kullanarak eklentide oturum açmalıdır. Öğrenci kullanıcılardan eklentide oturum açmaları istenirse Google TOA'yı kullanarak oturum açmalıdırlar. |
Zorunlu | |
| 2.2 | Eklenti, sonraki ziyaretlerde kullanıcıyı oturum açma istemi göstermeden otomatik olarak oturum açmak için Google TOA'yı KULLANMALIDIR. Oturum açma ipucu, şu anda oturum açmış kullanıcıyla eşleşmediğinde eklenti, kullanıcıya oturum açma düğmesiyle istemde bulunmalı ve geçersiz hesapları filtrelemek için login_hint'i kimlik doğrulama kitaplığına iletmelidir. |
Zorunlu | |
| 2.7 | Classroom kullanıcısı eklentide oturum açmamışsa (giriş ipucuna bakılarak belirlenir) oturum açma işlemini tetiklemek için kullanıcının açıkça işlem yapması gerekir. Bu nedenle, eklenti "Google ile oturum aç" düğmesini göstermelidir. Not: Bu, Google markalama kurallarına uymak için gereklidir ve pop-up engelleyicilerin kullanılmasını önlemeye de yardımcı olur. |
Zorunlu | |
| 2.8 | Eklenti, oturum açmış durumdaki kullanıcının kim olduğunu GÖSTERMELİDİR. | ÖNERİLİR | |
| 3.0 | Genel (General) | ||
| 3.1 | Eklenti, genel Google Workspace Marketplace onay yönergelerine UYMALIDIR. | Zorunlu | |
| 3.2 | Bir görev, iframe yolculuklarından herhangi birinden yeni bir sekmede veya pencerede başlatılırsa Classroom'a dönmek için kullanıcı dostu bir mesaj GÖSTERİLMELİDİR. | ÖNERİLİR | |
| 3.3 | Kullanıcı, yolculuğu YALNIZCA bir eklenti iş akışını kullanarak tamamlamalı, CourseWork iş akışına geçmemeli veya Classroom paylaşım düğmesini kullanmamalıdır. | Zorunlu | |
| 3.4 | Yerelleştirme seçimi: Dil, varsa tarayıcı tarafından belirlenen yerel tercihe göre AYARLANMALIDIR. | ÖNERİLİR | |
| 3,5 | Bir eklenti maxPoints tanımlıyorsa, öğrenci kayıtlı öğretmen kimlik bilgilerini kullanarak bir gönderimi tamamladığında (önerilir) VEYA öğretmen, öğrenci çalışması inceleme iFrame'inde gönderimi açtığında pointsEarned değerini de ayarlaması GEREKİR. |
Zorunlu | |
| 3,9 | Eklentiler, erişilebilirlik konusunda WCAG 2.1 düzey AA yönergelerine UYGUN OLMALIDIR. Eklenti geliştiriciler, gönderim sırasında bu şartın karşılandığını ve eklentinin gelecekte eklentide yapılacak değişikliklere uygun olmaya devam edeceğini kendi beyanlarıyla bildireceklerdir. | ÖNERİLİR | |
| 3.10 | Kullanıcının karşılaştığı tüm hatalar okunabilir OLMALIDIR. | ÖNERİLİR | |
| 3.11 | studentViewUri, teacherViewUri veya studentWorkViewUri, kopyalanmış bir ödevden ya da kopyalanmış bir kurstan başlatılırsa eklenti, iframe'de hata sayfası GÖSTERMEMELİDİR. |
Zorunlu | |
| 4,0 | Ek Keşfi | ||
| 4.1 | Bir ek için öğrenci gönderimi gerekiyorsa ek, içerik türü eki olarak değil etkinlik türü olarak değerlendirilmesi için studentWorkReviewUri içermelidir. |
Zorunlu | |
| 4,2 | Ek Bulma iFrame'i, en az aşağıdakilerden birini sunan bir kullanıcı arayüzü sağlamalıdır:
|
Zorunlu | |
| 4,3 | Öğretmen, kendisine sunulan tüm içeriklere/etkinliklere erişebilmelidir. | ÖNERİLİR | |
| 4.4 | Öğretmen, içeriği/etkinliği ödeve eklemeyi kabul etmeden önce önizleyebilmelidir. | ÖNERİLİR | |
| 4,5 | İçeriğin/etkinliğin eklenebilmesi için öğretmenin önceden içerik oluşturması gerekiyorsa bu işlem IFRAME'de yapılmalıdır. | ÖNERİLİR | |
| 5.0 | Öğrenci Görünümü | ||
| 5.1 | studentViewUri başlatıldığında, eklenti kullanıcının bir görevi tamamlamak için iframe'den çıkmasına İZİN VERMEMELİDİR.Eklenti, kullanıcının iframe'den çıkmasına izin verirse öğrencilerin Classroom'a dönmesi için bir mesaj veya başka bir gösterge OLMALIDIR. |
ÖNERİLİR | |
| 5.2 | Bir eklenti etkinliği iFrame'den çıkarsa iFrame'de görevle ilgili bir önizleme OLMALIDIR. | ÖNERİLİR | |
| 5.3 | Etkinlikte Teslim et etiketli bir düğme veya bağlantı varsa öğretmen incelemesi için öğrencinin çalışmasını göndermek üzere bir API isteği gönderilmelidir. | Zorunlu | |
| 6.0 | Öğretmen Görünümü | ||
| 6.1 | Öğretmen, öğrenci ödevi yaparken ne göreceğini GÖREBİLMELİDİR. | ÖNERİLİR | |
| 7.0 | Öğrenci Çalışması İncelemesi | ||
| 7.1 | studentWorkReviewUri başlatılırsa eklenti, öğrencinin çalışmasını öğretmen incelemesi için iFrame içinde oluşturmalıdır. Ek materyal, iFrame'in dışına bağlantı verebilir. |
Zorunlu | |
| 7.2 | Eklenti, studentWorkReviewUri görünümünde öğrenciler arasında gezinmeyi ETKİNLEŞTİRMEMELİDİR. Öğrenciler arasında gezinme YALNIZCA Classroom kullanıcı arayüzünde yapılmalıdır. |
Zorunlu | |
| 8.0 | Classroom mobil desteği | ||
| 8.1 | Classroom mobil uygulaması teacherViewUri, studentViewUri veya studentWorkReviewUri başlattığında URL, iş ortağının mobil yerel uygulamasını ya da mobil web uygulamasını açmalı ve her iki durumda da doğru görünüme derin bağlantı oluşturmalıdır. Cihaz desteklenmiyorsa kullanıcıya desteklenmeyen bir cihaz olduğunu ve ideal olarak hangi cihazların desteklendiğini bildiren bir mesaj GÖSTERİLMELİDİR. |
Zorunlu | |
| 8.2 | Öğrenci çalışmaları mobil cihazda tamamlanabilmelidir. | ÖNERİLİR | |
| 9.0 | Ek özellikler | ||
| 9.1 | Öğretmenler, içeriklerinize bağlantı ekleri olarak bağlantı yapıştırabiliyorsa bağlantıları eklenti eklerine yükseltmelisiniz. | ÖNERİLİR | |
| 9.2 | Classroom dışında ödev oluşturmak için CourseWork entegrasyonunu kullanıyorsanız eklentinizle uyumlu tüm bağlantılar için varsayılan olarak eklenti ekleri oluşturmalısınız. | ÖNERİLİR | |
Değişiklik günlüğü
| Sürüm 1.1 | Güncelleme: 5 Aralık 2024 |
| 1.1, 1.3, 3.2, 3.10, 4.4, 5.2 | ZORUNLU'dan ÖNERİLEN'e değiştirildi. |
| 3.12 | Kaldırıldı. |
| 5.3 | Yeniden ifade edildi. Yakın zamanda yapılan bir değişiklik, eklenti geliştiricilerin API'yi kullanarak öğrencilerin gönderimlerini güvenilir bir şekilde teslim etmelerine olanak tanıyor. |
| Sürüm 1.0 | Güncelleme tarihi: 30 Nisan 2024 |
| 1.1 | 1.1 ve 1.2, tek bir şartta birleştirildi. |
| 2.1 | 2.1 ve 2.5'i tek bir şartta birleştirdi. |
| 2.2 | 2.2, 2.3 ve 2.4'ü tek bir şartta birleştirdik. |
| 3,5 | 3.5, 3.6 ve 3.7'yi tek bir şartta birleştirdik. |
| 3.10 | Eklentinin hiçbir zaman anlaşılmaz veya kurtarılamaz bir duruma girmemesi şartı eklendi. |
| 3.11, 3.12 | 5.5, 5.6, 6.3, 6.4, 7.5 ve 7.6 maddelerini iki yeni şartta birleştirdik. |
| 4,2 | Kabul edilebilir Ek Bulma deneyimlerinin açıklaması genişletildi. |
| 4,3 | Numarası değiştirildi, eski numarası 4.2. Ayrıca, ZORUNLU'dan ÖNERİLEN'e değiştirildi. |
| 4.4 | Yeniden numaralandırıldı, eski numarası 4.3. |
| 4,5 | Yeniden numaralandırıldı, eski numarası 4.4. |
| 5.2 | Numarası değiştirildi, eski numarası 5.3. |
| 5.3 | Numarası değiştirildi, eski numarası 5.2. |
| 9.1 | Yapıştırılan bağlantıları eklere yükseltme önerisi eklendi. |
| 9.2 | CourseWork ödevleri programatik olarak oluşturulurken varsayılan olarak eklenti ekleri oluşturma önerisi eklendi. |
| 2.6, 3.7, 3.8, 6.2, 7.3, 7.4 | Kaldırıldı. |
| Sürüm 0.3 | Güncelleme tarihi: 22 Kasım 2022 |
| 2.3 | Giriş ipucu yönergelerinde düzeltme yapıldı. |
| 2.4 | hd öğesinin uygulanmasının zorunlu olduğu bir senaryo eklendi. |
| 3.2 | "Yol sağlama" ifadesi yeniden yazıldı. |
| 5.5, 5.6, 6.3, 6.4, 7.5, 7.6 | studentViewUri, teacherViewUri ve studentWorkReviewUri için zorunlu ve önerilen kurs kopyalama yönergeleri eklendi. |
| Sürüm 0.2 | Güncelleme: 29 Ekim 2021 |
| 1.3 | Metni, amaç daha net olacak şekilde düzenledi. |
| 3.1 | "Eklenti, web sitesinde bulunan genel GWM onay yönergelerine UYMALIDIR." ifadesi eklendi. |
| 3,9 | WCAG, ZORUNLU'yu ÖNERİLEN olarak değiştirdi. |
| 5.1 | ZORUNLU olan ayar ÖNERİLEN olarak değiştirildi. |
| 5.3 | "Eklentiler iFrame'den çıkarsa iFrame'de görevle ilgili bir önizleme OLMALIDIR." ifadesi eklendi. |
| 5.4 | "Eklenti iFrame'den çıkarsa öğrencilerin Classroom'a dönmesi İÇİN bir istem OLMALIDIR." ifadesi eklendi. |
| 8.1 | "Cihaz desteklenmiyorsa kullanıcıya desteklenmeyen bir cihaz olduğunu bildiren ve ideal olarak hangi cihazların desteklendiğini belirten bir mesaj GÖSTERİLMELİDİR." ifadesi eklendi. |
| 8.2 | Mobil öğrenci çalışması, ZORUNLU'dan ÖNERİLEN'e değiştirildi. |
| Sürüm 0.1 | Güncelleme: 22 Eylül 2021 |
| İlk sürüm. |