Eklenti gereksinimleri

Sürüm 1.0, 30 Nisan 2024.

Bu sayfadaki ölçütler tüm Classroom eklentileri için geçerlidir. Sizin eklenti, listelenmek üzere onay almak için geçerli tüm gerekli öğeleri karşılamalıdır. Google Workspace Marketplace ve "Aşağıdakilerle çalışan Classroom".

Şu anahtar kelimeler "ZORUNLU", "ZORUNLU OLMAMALIDIR", "GEREKLİ", "YAPILMAYACAK", "YA ALINMAMALIDIR", "KULLANMAMALIDIR", "ÖNERİLİR", "MAYIS" ve "İSTEĞE BAĞLI" bu belgedeki bilgilerin RFC 2119'da açıklandığı gibi yorumlanı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ö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 belirlenir) eklentinin "Google ile oturum aç" istemini göstermesi ZORUNLUDUR oturum açma işlemini tetiklemek için açık kullanıcı işlemi düğmesini tıklayın.
Not: Bu, Google 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
  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ı 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 tanımlıysa, öğ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İLİR
  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İLİR
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İLİR
  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İ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 çıkarıyorsa öğrencilerin Classroom'a dönmesi için bir mesaj veya başka bir uyarı BULUNMAMALIDIR.
ÖNERİLİR
  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şaretlemek için işlem yapmasını gerektiriyorsa, düğme "Teslim Et" olarak ETİKETLEMEMALIDIR. kullanarak Classroom'daki Teslim düğmesiyle ilgili karışıklığı önler. Zorunlu
6.0 Öğretmen Görünümü
  6.1 Öğretmen, öğrencinin ödevi yaparken neler göreceğini GEREKLİ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 gezinmenin yalnızca Classroom kullanıcı arayüzünde yapılması 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ı ZORUNLUDUR. ÖNERİLİR
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İ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 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 durumu kurtaramazsınız.
3.11, 3.12 5.5, 5.6, 6.3, 6.4, 7.5 ve 7.6 iki yeni sürüm içinde birleştirilerek gereksinimlerini karşılayın.
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, şu şekilde değiştirildi: ÖNERİLİR.
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 Aşağıdaki durumlarda varsayılan olarak eklenti ekleri oluşturma önerisi eklendi daha fazla bilgi edindiniz.
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 uygulamasının geçerli olduğu bir senaryo eklendi. gereklidir.
3.2 "Yol belirtin" ifadesi yeniden adlandırıldı.
5,5, 5,6, 6,3, 6,4, 7,5, 7,6 Kurs için gerekli olan ve önerilen yönergeler eklendi studentViewUri, teacherViewUri ve studentWorkReviewUri.
Sürüm 0.2 Güncelleme tarihi: 29 Ekim 2021
1.3 Metin, niyeti daha net olacak şekilde düzenlendi.
3.1 "Eklenti, genel GWM onay yönergelerine UYMALIDIR" eklendi buldukları için teşekkür ederiz."
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, önizlemelerine görev hakkında daha fazla bilgi edinin."
5.4 "Eklenti iframe'in dışına çıkarsa bir istem OLMALIDIR. geri bildirim gönderin."
8.1 "Cihaz desteklenmiyorsa desteklenmeyen bir cihaz olduğunu bilsin ve ideal olarak cihazlar destekleniyor."
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.