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. Eklentinin kullanılamamasının nedeni mesajda net bir şekilde belirtilmeli ve kullanıcının durumu düzeltmesi için bir işlem önerisi sunulmalıdır. | ÖNERİLİR | |
| 1.3 | Eklentinin Google Workspace Marketplace girişinde, eklentinin kullanılması için gerekli olabilecek lisans ve abonelik 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 sunan bir web sayfasının bağlantısı YER ALMALIDIR. | ÖNERİLİR | |
| 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 login_hint parametresini kimlik doğrulama kitaplığına ileterek geçersiz hesapları filtrelemelidir. |
Zorunlu | |
| 2,7 | Classroom kullanıcısı eklentide oturum açmamışsa (giriş ipucundan anlaşılır) eklentide, oturum açma işlemini tetiklemek için kullanıcının açıkça işlem yapması amacıyla bir "Google ile oturum aç" düğmesi ZORUNLUDUR. Not: Bu, Google markalaşma yönergelerine uymak için gereklidir ve pop-up engelleyicilerin önüne geçmeye yardımcı olur. |
Zorunlu | |
| 2,8 | Eklenti, şu anda oturum açmış olan kullanıcıyı GÖSTERMELİDİR. | ÖNERİLİR | |
| 3.0 | Genel (General) | ||
| 3.1 | Eklenti, genel Google Workspace Marketplace onay kurallarına UYGUN OLMALIDIR. | 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. | ÖNERİLİR | |
| 3.3 | Kullanıcı, yolculuğu yalnızca eklenti iş akışını kullanarak tamamlamalı, kurs iş akışına geçmemeli veya Classroom Paylaş düğmesini kullanmamalıdır. | Zorunlu | |
| 3.4 | Yerelleştirme seçimi: Dil, varsa tarayıcı tarafından ayarlanan yerel tercihe dayalı OLMALIDIR. | Ö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 düzey 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. | ÖNERİLİR | |
| 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 | |
| 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'si, aşağıdakilerden en az birini sunan bir kullanıcı arayüzü SAĞLAMALIDIR:
|
Zorunlu | |
| 4,3 | Öğretmen, kendisine sunulan tüm içerikleri/etkinlikleri bulup bunlara erişebilmelidir. | ÖNERİLİR | |
| 4.4 | Öğretmen, ödeve ekleme yapmadan önce içeriği/etkinliği önizleyebilmelidir. | ÖNERİLİR | |
| 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 etkinleştirildiğinde, eklenti bir görevi tamamlamak için kullanıcıyı iframe'den ÇIKARTMAMALIDIR.Eklenti kullanıcıyı iframe'den çıkarırsa öğrencilerin Classroom'a dönmesi için bir mesaj veya başka bir gösterge OLMALIDIR. |
ÖNERİLİR | |
| 5.2 | IFrame'den bir eklenti etkinliği açılırsa IFrame'de görevle ilgili bir önizleme OLMALIDIR. | ÖNERİLİR | |
| 5.3 | Varsa etkinlikte Teslim et etiketli bir düğme veya bağlantı, öğretmenin incelemesi için öğrencinin çalışmasını gönderme API isteği oluşturmalıdır. | 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 eklenti, öğretmenin incelemesi için söz konusu öğrencinin çalışmasını iframe içinde oluşturmalıdır. Ek materyal, iFrame'in dışında 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, 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ç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.1 | Güncelleme tarihi: 5 Aralık 2024 |
| 1.1, 1.3, 3.2, 3.10, 4.4, 5.2 | Zorunlu olan bu ayar, ÖNERİLİR olarak 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 öğrenci gönderimlerini güvenilir bir şekilde teslim etmelerine olanak tanır. |
| 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 şartta birleştirildi. |
| 3,5 | 3.5, 3.6 ve 3.7 sürümleri 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 bu ayar, ÖNERİLİR olarak değiştirildi. |
| 4.4 | Numarası değiştirildi (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 | Numarası değiştirildi (eski adıyla 5.2). |
| 9.1 | Yapıştırılan bağlantıları ek olarak 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 | 29 Ekim 2021'de güncellendi |
| 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, ZORUNLU olan değeri ÖNERİLİR olarak değiştirdi. |
| 5.1 | ZORUNLU olan değer ÖNERİLEN 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. |
| 0.1 sürümü | 22 Eylül 2021'de güncellendi |
| İlk sürüm. |