Eklenti gereksinimleri

Sürüm 1.0, 30 Nisan 2024.

Bu sayfadaki ölçütler tüm Classroom eklentileri için geçerlidir. Eklentiniz, Google Workspace Marketplace'te listelenmek üzere onay almak için ilgili tüm gerekli öğeleri ve "Classroom ile uyumlu" bir eklentiyi karşılamalıdır.

Bu belgedeki "ZORUNLU", "ZORUNLU OLMAMALIDIR", "GEREKLİ", "YAPILMAYACAK", "YAPILMAYACAK", "GEREKLİ", "KULLANILMAMASI GEREKEN", "ÖNERİLİR", "OLABİLECEK" ve "İSTEĞE BAĞLI" anahtar kelimeleri RFC 2119'da açıklandığı şekilde yorumlanmalıdır.

Koşullar

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österilmesi ZORUNLUDUR. 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, eklentiyi kullanmak için gerekli olabilecek lisanslama şartları hakkında ayrıntılar BELİRTİLMELİDİR. Eklentinin ücretli bir katmanı varsa Pazar Yeri girişinde, fiyatlandırma veya satış görevlisiyle nasıl iletişim kurulacağı hakkında daha fazla bilgi sağlayan bir web sayfasının bağlantısı ZORUNLUDUR. Zorunlu
2,0 Son kullanıcı oturum açma
  2.1 Öğretmen kullanıcılarının Google TOA'yı kullanarak eklentide oturum açması ZORUNLUDUR.
Öğrenci kullanıcılardan eklentide oturum açmaları istenirse Google TOA kullanarak oturum açmaları ZORUNLUDUR.
Zorunlu
  2.2 Eklentinin, sonraki ziyaretlerde giriş istemi göstermeden kullanıcının oturumunu otomatik olarak açması için Google TOA'yı kullanması ZORUNLUDUR.
Giriş ipucu, o anda oturum açmış kullanıcıyla bir eşleşme bulamazsa eklentinin, kullanıcıya bir oturum açma düğmesi iletmesi ve geçersiz hesapları filtrelemek için giriş_hint'ini kimlik doğrulama kitaplığına iletmesi ZORUNLUDUR.
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 amacıyla kullanıcının açıkça işlem 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İLEN
3,0 Genel
  3.1 Eklenti, genel Google Workspace Marketplace onay yönergelerine UYMALIDIR. Zorunlu
  3.2 Bir görev, iframe yolculuklarının herhangi birinde yeni bir sekmede veya pencerede başlatılırsa Classroom'a geri dönmesi için kullanıcı dostu bir mesaj sağlaması ZORUNLUDUR. Zorunlu
  3.3 Kullanıcının yolculuğu yalnızca eklenti iş akışı kullanarak tamamlaması, bircourseWork akışına geçiş yapmaması veya Classroom'daki Paylaş Düğmesini kullanmaması ZORUNLUDUR. Zorunlu
  3.4 Yerelleştirme seçimi: dil, mümkün olduğunda tarayıcı tarafından belirlenen yerel tercihe dayanmalıdır. ÖNERİLEN
  3,5 Bir eklenti maxPoints öğesini tanımlıyorsa, öğrenci depolanan öğretmen kimlik bilgilerini kullanarak gönderimi tamamladığında (önerilir) VEYA öğretmen, ödevi Öğrenci Çalışma İncelemesi iframe'inde açtığında da pointsEarned öğesinin ayarlanması ZORUNLUDUR. Zorunlu
  3,9 Eklentiler, erişilebilirlikle ilgili WCAG 2.1 seviye AA yönergelerine UYMALIDIR. Eklenti geliştiricileri, bu şartın gönderim sırasında karşılandığını ve eklentinin gelecekte yapılacak değişikliklere uyum sağlamaya devam ettiğini bildirecektir. ÖNERİLEN
  3,10 Kullanıcıların yaşadığı tüm hataların okunabilir olması ZORUNLUDUR. Zorunlu
  3:11 studentViewUri, teacherViewUri veya studentWorkViewUri kopyalanan bir ödevden veya kopyalanan dersten başlatılırsa eklentinin iframe'de bir hata sayfası GÖRÜNTÜLEMEMELİDİR. Zorunlu
  3,12 studentViewUri, teacherViewUri veya studentWorkViewUri kopyalanan bir ödevden veya kopyalanan dersten başlatıldıysa eklentinin öğrencinin tamamlaması için yeni bir ek göstermesi ve öğrencinin önceki ödevlere ya da derslere ait yanıtlarını iframe'de GÖRÜNTÜLEMEMELİDİR. ÖNERİLEN
4.0 Ek Bulma
  4,1 Bir ek, öğrencinin gönderimini gerektiriyorsa, içerik türü eki değil, etkinlik türü olarak değerlendirilmesi için ekin studentWorkReviewUri içermesi ZORUNLUDUR. Zorunlu
  4,2 Ek Keşfi iframe'inin, aşağıdakilerden en az birini sunan bir kullanıcı arayüzü sağlaması ZORUNLUDUR:
  • Eklenecek yeni içerik oluşturun
  • İçerik kitaplığından göz atma, seçme ve ekleme
  • Web sitenizden veya diğer ürünlerden içerik ekleme talimatları
Zorunlu
  4,3 Öğretmen, öğretmenin kullanabileceği tüm içerikleri/etkinlikleri bulabilmelidir ve bunlara erişebilmelidir. ÖNERİLEN
  4.4 Öğretmenin, ödeve ekleme taahhüdünde bulunmadan önce içeriği/etkinliği önizleyebilmesi GEREKİR. Zorunlu
  4,5 Öğretmenin, eklenebilmesi için içerik/etkinlik oluşturmak üzere çalışması gerekiyorsa söz konusu çalışmanın iframe'de TAMAMLANMALIDIR. ÖNERİLEN
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 çıkarıyorsa öğrencilerin Classroom'a dönmesi için bir mesaj veya başka bir uyarı BULUNMAMALIDIR.
ÖNERİLEN
  5.2 Bir eklenti etkinliği iframe'in dışına çıkarsa iframe'de görevle ilgili bir önizleme ZORUNLUDUR. Zorunlu
  5.3 Bir etkinlik, öğrencinin çalışmayı tamamlandı olarak işaretlemesi için bir işlem yapmasını gerektiriyorsa, Classroom'daki Teslim düğmesiyle karışıklığa yol açmamak adına bu düğmenin "Teslim Et" olarak etiketlenmemesi ZORUNLUDUR. Zorunlu
6.0 Öğretmen Görünümü
  6.1 Öğretmen, öğrencinin ödevi yaparken neler göreceğini GEREKLİDİR. ÖNERİLEN
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 gezinmenin yalnızca Classroom kullanıcı arayüzüyle gerçekleştirilmesi ZORUNLUDUR. Zorunlu
8,0 Classroom mobil desteği
  8.1 Classroom mobil uygulaması bir teacherViewUri, studentViewUri veya studentWorkReviewUri uygulamasını başlattığında URL'nin, iş ortağının mobil yerel uygulamasını veya iş ortağının mobil web uygulamasını açması ve her iki durumda da doğru görünüme derin bağlantısını açması ZORUNLUDUR. 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ının mobil cihazda tamamlanması GEREKİR. ÖNERİLEN
9,0 Ek özellikler
  9.1 Öğretmenler içeriğinize bağlantıları bağlantı ekleri olarak yapıştırabiliyorsa bağlantıları eklenti eklerine yükseltmeniz GEREKİR. ÖNERİLEN
  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İLEN

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 koşulda birleştirildi.
2.1 2.1 ve 2.5 tek bir koşulda 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şılmayan veya kurtarılamaz bir duruma geçmemesi şartı eklendi.
3.11, 3.12 5.5, 5.6, 6.3, 6.4, 7.5 ve 7.6 iki yeni gereksinimde birleştirildi.
4,2 Kabul edilebilir Ek Keşfi deneyimleriyle ilgili açıklama genişletildi.
4,3 Yeniden numaralandırılmış (eski adıyla 4.2). ZORUNLU olan da ÖNERİLEN olarak değiştirildi.
4.4 Yeniden numaralandırılmış (eski adıyla 4.3).
4,5 Yeniden numaralandırılmış (eski adıyla 4.4).
5.2 Yeniden numaralandırılmış (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 atamaları’nı 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 Güncelleme tarihi: 22 Kasım 2022
2.3 Giriş ipucu kılavuzunda düzeltme.
2.4 hd uygulanmasının gerekli olduğu bir senaryo eklendi.
3.2 "Yol belirtin" ifadesi yeniden adlandırıldı.
5,5, 5,6, 6,3, 6,4, 7,5, 7,6 studentViewUri, teacherViewUri ve studentWorkReviewUri için kurs kopyası zorunlu ve önerilen kılavuz eklendi.
Sürüm 0.2 Güncelleme tarihi: 29 Ekim 2021
1.3 Metin, niyeti daha net olacak şekilde düzenlendi.
3.1 "Eklenti, web sitelerinde bulunan genel GWM onay yönergelerine UYMALIDIR" eklendi.
3,9 WCAG, REQUIRED (ÖNERİLDİ) olarak değiştirildi.
5.1 REQUIRED, RECOMMENDED olarak değiştirildi.
5.3 "Eklentiler iframe'in dışına çıkarsa iframe'de görevle ilgili bir önizlemenin olması ZORUNLUDUR." eklendi.
5.4 "Eklenti iframe'in dışına çıkarsa öğrencilerin Classroom'a dönmesi için bir istem OLMALIDIR" eklendi.
8.1 "Cihaz desteklenmiyorsa, desteklenmeyen bir cihaz olduğunu ve ideal olarak hangi cihazların desteklendiğini bildiren bir mesaj gösterilmesi ZORUNLUDUR."
8.2 ZORUNLU olan mobil öğrenci çalışmaları, ÖNERİLİR olarak değiştirildi.
Sürüm 0.1 Güncelleme tarihi: 22 Eylül 2021
  İlk sürüm.