Sürüm 1.0, 30 Nisan 2024.
Bu sayfadaki ölçütler tüm Classroom eklentileri için geçerlidir. Eklentinizin, Google Workspace Marketplace'te listelenmek ve "Classroom ile çalışır" etiketini almak için onaylanması amacıyla geçerli tüm gerekli öğeleri karşılaması gerekir.
Bu belgedeki "MUST" (GEREKİYOR), "MUST NOT" (GEREKMEZ), "REQUIRED" (ZORUNLU), "SHALL" (OLMALI), "SHALL NOT" (OLMAMALI), "SHOULD" (OLMALI), "SHOULD NOT" (OLMAMALI), "RECOMMENDED" (ÖNERİLİR), "MAY" (OLUR) ve "OPTIONAL" (İSTEĞE BAĞLI) anahtar kelimeleri RFC 2119'da açıklandığı şekilde yorumlanmalıdır.
Şartlar
| Kimlik | Tür | ||
|---|---|---|---|
| 1.0 | Son Kullanıcı Lisansı (varsa) | ||
| 1.1 | Kullanıcının lisansı yoksa kullanıcıya kullanıcı dostu bir mesaj GÖSTERİLMELİDİR. Mesajda, eklentinin neden kullanılamadığının açık bir şekilde belirtilmesi ve kullanıcının durumu düzeltmesi için bir eylem planı önerilmesi ZORUNLUDUR. | Zorunlu | |
| 1.3 | Eklentinin Google Workspace Marketplace girişinde, eklentinin kullanılması için gerekli olabilecek lisanslama koşullarıyla ilgili ayrıntılar belirtilmelidir. Eklentinin ücretli bir katmanı varsa pazar yeri girişinde, fiyatlandırma veya satış temsilcisiyle nasıl iletişime geçileceği hakkında daha fazla bilgi sağlayan bir web sayfasının bağlantısı ZORUNLUDUR. | Zorunlu | |
| 2,0 | Son kullanıcı oturumu açma | ||
| 2.1 | Öğretmen kullanıcılarının eklentide Google TOA'yı kullanarak oturum açması GEREKİR. Öğrenci kullanıcılardan eklentide oturum açmaları istenirse Google TOA'yı kullanarak oturum açmaları GEREKİR. |
Zorunlu | |
| 2.2 | Eklenti, bir kullanıcının sonraki ziyaretlerde oturumunu otomatik olarak açmak için giriş istemi göstermeden Google TOA'yı KULLANMAK ZORUNDADIR. Giriş ipucu, şu anda oturum açmış olan kullanıcıyla eşleşmediğinde eklenti, kullanıcıya bir oturum açma düğmesi göstererek giriş yapmasını İSTEMEK ZORUNDADIR ve geçersiz hesapları filtrelemek için login_hint parametresini kimlik doğrulama kitaplığına iletmelidir. |
Zorunlu | |
| 2,7 | Classroom kullanıcısı eklentide henüz oturum açmamışsa (giriş ipucuna bakarak belirlendiği şekilde) eklentinin, oturum açma işlemini tetiklemesi için kullanıcının açıkça işlemi yapması için "Google ile oturum aç" düğmesi GÖRÜNTÜLEMELİDİR. Not: Bu, Google'ın markalama kurallarına uymak için gereklidir ve pop-up engelleyicilerin önlenmesine yardımcı olur. |
Zorunlu | |
| 2,8 | Eklenti, oturum açmış olan kullanıcının kim olduğunu GÖRÜNTÜLEMELİ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 birinde yeni bir sekmede veya pencerede başlatılırsa Classroom'a dönmek için kullanıcı dostu bir mesaj gösterilmelidir. | Zorunlu | |
| 3.3 | Kullanıcının yolculuğu yalnızca eklenti iş akışı kullanarak tamamlaması ve bircourseWork akışı arasında geçiş yapmaması veya Classroom'daki Paylaş Düğmesini kullanmaması gerekir. | Zorunlu | |
| 3.4 | Yerelleştirme seçimi: dil, mümkün olduğunda tarayıcı tarafından belirlenen yerel tercihe dayanmalıdır. | ÖNERİLİR | |
| 3,5 | Bir eklenti maxPoints değerini tanımlıyorsa öğrenci, depolanan öğretmen kimlik bilgilerini kullanarak bir gönderimi tamamladığında (önerilen) VEYA öğretmen, gönderimi Öğrenci Çalışması İncelemesi iFrame'inde açtığında pointsEarned değerini de ayarlamalıdır. |
Zorunlu | |
| 3,9 | Eklentiler, erişilebilirlikle ilgili WCAG 2.1 seviye AA yönergelerine UYGUN OLMALIDIR. Eklenti geliştiricileri, gönderim sırasında bu şartın karşılandığını ve eklentinin gelecekte eklentide yapılacak değişikliklerle uyumlu olmaya devam ettiğini kendileri beyan eder. | ÖNERİLİR | |
| 3,10 | Kullanıcının yaşadığı tüm hatalar kullanıcı tarafından okunabilir OLMALIDIR. | Zorunlu | |
| 3.11 | studentViewUri, teacherViewUri veya studentWorkViewUri, kopyalanan bir ödevden ya da kopyalanan bir kurstan başlatılırsa eklenti, iframe'de hata sayfası GÖSTERMEMELİDİR. |
Zorunlu | |
| 3.12 | studentViewUri, teacherViewUri veya studentWorkViewUri, kopyalanan bir ödevden ya da kopyalanan bir kurstan başlatılırsa eklenti, öğrencinin doldurması için yeni bir ek GÖSTERMELİDİR ve öğrencinin önceki ödevler ya da kurslardaki yanıtlarını iframe'de GÖSTERMEMELİDİR. |
ÖNERİLİR | |
| 4,0 | Ek Keşfi | ||
| 4.1 | Bir eke öğrenci gönderimi gerekiyorsa ek, içerik türü eki olarak değil, etkinlik türü eki olarak değerlendirilmesi için studentWorkReviewUri içermelidir. |
Zorunlu | |
| 4,2 | Ek Keşfi iframe'inin, aşağıdakilerden en az birini sunan bir kullanıcı arayüzü sağlaması ZORUNLUDUR:
|
Zorunlu | |
| 4,3 | Öğretmen, öğretmenin kullanabileceği tüm içerikleri/etkinlikleri bulabilmelidir ve bunlara erişebilmelidir. | ÖNERİLİR | |
| 4.4 | Öğretmenin, ödeve ekleme taahhüdünde bulunmadan önce içeriği/etkinliği önizleyebilmesi GEREKİR. | Zorunlu | |
| 4,5 | Öğretmenin, içerik/etkinlik eklemeden önce içerik/etkinlik oluşturması gerekiyorsa bu işlem iframe'de tamamlanmalıdır. | ÖNERİLİR | |
| 5,0 | Öğrenci Görünümü | ||
| 5.1 | studentViewUri kullanıma sunulduğunda, eklentinin bir görevi tamamlamak için kullanıcıyı iframe'in dışına KALDIRILMAMASI GEREKİR.Eklenti, kullanıcıyı iFrame'in dışına çıkarsa öğrencilerin Classroom'a dönmesi için bir mesaj veya başka bir uyarı BULUNMAMALIDIR. |
ÖNERİLİR | |
| 5.2 | iFrame'den bir eklenti etkinliği açılırsa iFrame'de görevle ilgili bir önizleme OLMALIDIR. | Zorunlu | |
| 5.3 | Bir etkinlikte öğrencinin çalışmayı tamamladığını işaretlemek için işlem yapması gerekiyorsa Classroom'daki teslim düğmesiyle karışıklık olmaması için düğme "Teslim et" olarak etiketlenmemelidir. | Zorunlu | |
| 6.0 | Öğretmen Görünümü | ||
| 6.1 | Öğretmen, öğrencinin ödevi yaparken göreceği bilgileri GÖREBİLMELİDİR. | ÖNERİLİR | |
| 7.0 | Öğrenci Çalışması İncelemesi | ||
| 7.1 | studentWorkReviewUri başlatılırsa eklentinin, öğrencinin çalışmasını öğretmen incelemesi için iframe içinde oluşturması ZORUNLUDUR. 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 işlemi yalnızca Classroom kullanıcı arayüzünde yapılmalıdır. |
Zorunlu | |
| 8,0 | Classroom mobil desteği | ||
| 8.1 | Classroom mobil uygulaması bir 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 cihazın desteklenmeyen bir cihaz olduğunu ve ideal olarak hangi cihazların desteklendiğini bildiren bir mesaj GÖRÜNTÜLENMELİDİR. |
Zorunlu | |
| 8.2 | Öğrenci çalışmaları mobil cihazda tamamlanabilmelidir. | ÖNERİLİR | |
| 9.0 | Ek özellikler | ||
| 9.1 | Öğretmenler, içeriğinize bağlantı ekleri olarak bağlantı yapıştırabiliyorsa bağlantıları eklenti eklerine yükseltmeniz GEREKİR. | ÖNERİLİR | |
| 9.2 | Classroom dışından ödev oluşturmak için CourseWork entegrasyonu kullanıyorsanız eklentinizle uyumlu tüm bağlantılar için varsayılan olarak eklenti ekleri oluşturmanız GEREKİR. | ÖNERİLİR | |
Değişiklik günlüğü
| 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 numaralı şartlar tek bir şartta birleştirildi. |
| 2.2 | 2.2, 2.3 ve 2.4 tek bir koşulda birleştirildiğinde. |
| 3,5 | 3.5, 3.6 ve 3.7 tek bir şartta birleştirildi. |
| 3,10 | Eklentinin hiçbir zaman anlaşılamayan veya kurtarılamayan bir duruma girmemesi şartı eklendi. |
| 3.11, 3.12 | 5.5, 5.6, 6.3, 6.4, 7.5 ve 7.6 maddeleri iki yeni şart altında birleştirildi. |
| 4,2 | Kabul edilebilir ek bulma deneyimlerinin açıklaması genişletildi. |
| 4,3 | Numarası değiştirildi (eski adıyla 4.2). Ayrıca ZORUNLU olan değer, ÖNERİLİR olarak değiştirildi. |
| 4.4 | Yeniden numaralandırılmış (eski adıyla 4.3). |
| 4,5 | Numarası değiştirildi (eski adıyla 4.4). |
| 5.2 | Numarası değiştirildi (eski adıyla 5.3). |
| 5.3 | Yeniden numaralandırılmış (eski adıyla 5.2). |
| 9.1 | Yapıştırılan bağlantıları eklere yükseltme önerisi eklendi. |
| 9.2 | CourseWork ödevlerini programatik olarak oluştururken 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 | 22 Kasım 2022'de güncellendi |
| 2.3 | Giriş ipucu kılavuzunda düzeltme yapıldı. |
| 2.4 | hd'ün uygulanmasının zorunlu olduğu bir senaryo dahil edildi. |
| 3.2 | "Yol sağlayın" ifadesi yeniden ifade edildi. |
| 5.5, 5.6, 6.3, 6.4, 7.5, 7.6 | studentViewUri, teacherViewUri ve studentWorkReviewUri için kurs kopyası ile ilgili zorunlu ve önerilen yönergeler eklendi. |
| Sürüm 0.2 | Güncelleme tarihi: 29 Ekim 2021 |
| 1.3 | Metnin amacı daha net olacak şekilde düzenlendi. |
| 3.1 | "Eklentinin, web sitesinde bulunan genel GWM onay yönergelerine uyması GEREKİR." ifadesi eklendi. |
| 3,9 | WCAG, REQUIRED, RECOMMENDED olarak değiştirildi. |
| 5.1 | REQUIRED, RECOMMENDED olarak değiştirildi. |
| 5.3 | "Eklentiler iframe'dan açılırsa iframe'da görevle ilgili bir önizleme OLMALIDIR." ifadesi eklendi. |
| 5.4 | "Eklenti, iFrame'den çıkarsa öğrencilerin Classroom'a dönmesi için bir istem GÖSTERİLMELİDİR." ifadesi eklendi. |
| 8.1 | "Cihaz desteklenmiyorsa kullanıcıya, desteklenmeyen bir cihaz kullandığını ve ideal olarak hangi cihazların desteklendiğini bildiren bir mesaj GÖSTERİLMELİDİR." ifadesi eklendi. |
| 8.2 | Mobil öğrenci çalışmaları için ZORUNLU olan değer ÖNERİLİR olarak değiştirildi. |
| Sürüm 0.1 | 22 Eylül 2021'de güncellendi |
| İlk sürüm. |