Eklenti gereksinimleri

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 üzere onaylanması için gerekli tüm öğeleri ve "Classroom ile çalışan" bir eklentiyi karşılaması gerekir.

Bu belgedeki "ZORUNLUDUR", "ZORUNLUDUR", "GEREKLİ", "ALIŞVERİŞ", "ALMAMALIDIR", "ÖNERİLMEZ", "ÖNERİLİR", "MAYIS" 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 Lisansı olmayan kullanıcılara, kullanıcı dostu bir mesaj gösterilmesi ZORUNLUDUR. Mesajda, eklentinin kullanılamama nedeni net bir şekilde belirtilmeli ve kullanıcının bu durumu düzeltmek için yapması gereken işlem önerilmelidir. Zorunlu
  1.3 Eklentinin Google Workspace Marketplace girişinde, eklentiyi kullanmak için gerekli olabilecek lisanslama şartlarıyla ilgili ayrıntıların belirtilmesi ZORUNLUDUR. Eklentinin ücretli bir katmanı varsa Pazar Yeri girişinde, fiyatlandırma veya bir satış görevlisiyle nasıl iletişim kurulacağı hakkında daha fazla bilgi sağlayan bir web sayfasının bağlantısı SAĞLANMALIDIR. Zorunlu
2,0 Son kullanıcı oturumu açma
  2.1 Öğretmen kullanıcıların eklentide Google TOA kullanarak oturum açması ZORUNLUDUR.
Öğ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 ziyaretlerinde oturum açma istemi göstermeden otomatik olarak oturum açmasını sağlamak için Google TOA'yı kullanmalıdır.
Giriş ipucu, o anda oturum açmış olan kullanıcıyla eşleşme sağlamadığında, eklenti geçersiz hesapları filtrelemek için kullanıcıdan bir oturum açma düğmesiyle istemde bulunmalı ve "login_hint" değerini 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 üzere), eklentinin oturum açma işlemini tetiklemesi için açık kullanıcı işleminin bir "Google ile oturum aç" düğmesi sunması ZORUNLUDUR.
Not: Bu, Google markalama kurallarına uymak için gereklidir ve pop-up engelleyicilerinin engellenmesine de yardımcı olur.
Zorunlu
  2,8 Eklenti, şu anda oturum açmış kullanıcının kim olduğunu görüntülemelidir. ÖNERİLİR
3,0 Genel
  3.1 Eklenti, genel Google Workspace Marketplace onay yönergelerine uygun OLMALIDIR. 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 ileti SAĞLAMALIDIR. Zorunlu
  3.3 Kullanıcı yolculuğu yalnızca eklenti iş akışı kullanarak tamamlamalı ve bircourseWork akışına geçmemeli ya da Classroom'da Paylaş Düğmesini kullanmamalıdır. Zorunlu
  3.4 Yerelleştirme seçimi: Dil, kullanılabilir olduğunda tarayıcı tarafından ayarlanan yerel tercihe dayanmalıdır. ÖNERİLİR
  3,5 Bir eklenti maxPoints özelliğini tanımlıyorsa bir öğrenci, bir gönderimi kayıtlı öğretmen kimlik bilgilerini kullanarak tamamladığında (önerilir) VEYA öğretmen, gönderimi Öğrenci Çalışması İncelemesi iframe'inde açtığında da pointsEarned ayarının yapılması ZORUNLUDUR. Zorunlu
  3,9 Eklentiler, erişilebilirlikle ilgili WCAG 2.1 seviye AA yönergelerine UYMALIDIR. Eklenti geliştiricileri, bu gereksinimin gönderim sırasında karşılandığını ve eklentinin, gelecekte yapılacak değişikliklerle uyumlu olmaya devam ettiğini kendisi bildirecektir. ÖNERİLİR
  3,10 Bir kullanıcının karşılaştığı hatalar, kullanıcılar tarafından okunabilmelidir. Zorunlu
  3,11 studentViewUri, teacherViewUri veya studentWorkViewUri kopyalanan bir ödevden veya kopyalanan dersten başlatıldıysa eklenti, 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ılıyorsa eklenti, öğrencinin tamamlaması için yeni bir ek GÖRÜNTÜLEMELİDİR ve bir öğrencinin iframe'de önceki ödevlere veya derslere ilişkin yanıtlarını GÖRÜNTÜLEMEMELİDİR. ÖNERİLİR
4,0 Ek Bulma
  4,1 Öğrencinin gönderdiği bir ekin, içerik türü eki olarak değil, etkinlik türü olarak ele alınabilmesi 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ığında göz atma, seçme ve ekleme
  • Web sitenizden veya diğer ürünlerinizden içerik ekleme talimatları
Zorunlu
  4,3 Öğretmen, kullanabileceği tüm içeriği/etkinlikleri bulabilmeli ve bunlara erişebilmelidir. ÖNERİLİR
  4.4 Öğretmenin, içeriği/etkinliği ödeve eklemeyi taahhüt etmeden önce bunu önizleyebilmesi ZORUNLUDUR. Zorunlu
  4,5 Öğretmen, eklenmeden önce içerik/etkinlik oluşturmak için çalışma yapıyorsa bu çalışma iframe içinde tamamlanmalıdır. ÖNERİLİR
5,0 Öğrenci Görünümü
  5.1 studentViewUri kullanıma sunulduğunda eklenti, bir görevi tamamlaması için kullanıcıyı iframe'den ÇIKARMAMALIDIR.
Eklenti, kullanıcıyı iframe'den çıkarırsa öğrencilerin Classroom'a geri dönmesi için bir mesaj veya başka bir gösterge olması ZORUNLUDUR.
ÖNERİLİR
  5.2 Bir eklenti etkinliği iframe'den çıkarsa iframe'de görevle ilgili bir önizleme OLMALIDIR. Zorunlu
  5.3 Bir etkinlik, öğrencinin çalışmasını tamamlandı olarak işaretlemesi için bir işlem yapmasını gerektiriyorsa, Classroom'u Teslim Et düğmesiyle karışıklık olmaması için düğmenin 'Teslim Et' etiketiyle ETİKETLEMEMESİ GEREKİR. Zorunlu
6,0 Öğretmen Görünümü
  6.1 Öğretmen, öğrencinin ödevi yaparken ne göreceğini görebilmesi GEREKİR. ÖNERİLİR
7,0 Öğrenci Çalışması İncelemesi
  7.1 studentWorkReviewUri başlatılırsa eklenti, ilgili öğrencinin çalışmasını iframe içinde öğretmen incelemesi için OLUŞTURMALIDIR. 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 öğesini kullanıma sunduğunda, URL'nin iş ortağının mobil yerel uygulamasını veya mobil web uygulamasını açması ve her iki durumda da doğru görünüme derin bağlantı vermesi ZORUNLUDUR. Cihaz desteklenmiyorsa, kullanıcıya cihazın desteklenmeyen olduğunu ve ideal olarak hangi cihazların desteklendiğini bildiren bir mesaj gösterilmesi ZORUNLUDUR. Zorunlu
  8.2 Öğrenci çalışmaları mobil cihazdan tamamlanmalıdır. ÖNERİLİR
9,0 Ek özellikler
  9.1 Öğretmenler içeriğinize yönelik 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 birleştirilerek tek bir gereksinim haline gelir.
2.1 2.1 ve 2.5 birleştirilerek tek bir gereksinim haline gelir.
2.2 2.2, 2.3 ve 2.4'ü tek bir gereksinimde birleştirin.
3,5 3.5, 3.6 ve 3.7'yi tek bir gereksinimde birleştirin.
3,10 Eklentinin hiçbir zaman anlaşılmaz veya kurtarılamaz bir duruma girmemesi gereksinimi eklendi.
3:11, 3:12 5.5, 5.6, 6.3, 6.4, 7.5 ve 7.6 iki yeni gereksinimde birleştirilmiştir.
4,2 Kabul edilebilir Ek Keşfi deneyimlerinin açıklaması genişletildi.
4,3 Yeniden numaralandırılmış, 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 Yeniden numaralandırılmış, eski adıyla 4.4.
5.2 Yeniden numaralandı, eskiden 5.3.
5.3 Yeniden numaralandı, eskiden 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 gereksinimi 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 yapıldı.
2.4 hd uygulanmasının gerekli olduğu bir senaryo eklendi.
3.2 Yeniden ifade edilen "yol sağlayın".
5,5, 5,6, 6,3, 6,4, 7,5, 7,6 studentViewUri, teacherViewUri ve studentWorkReviewUri için gerekli ve önerilen rehberlik eklendi.
Sürüm 0.2 Güncelleme tarihi: 29 Ekim 2021
1.3 Metin, amacı daha net şekilde belirtecek şekilde değiştirildi.
3.1 "Eklentinin, web sitesinde bulunan genel GWM onay yönergelerine uyması ZORUNLUDUR."
3,9 WCAG, REQUIRED olarak RECOMMENDED olarak değiştirildi.
5.1 ZORUNLU olarak ÖNERİLİR olarak değiştirildi.
5.3 "Eklentiler iframe'den çıkarsa iframe'de görevle ilgili bir önizleme OLMALIDIR" eklendi.
5.4 "Eklenti iframe'den çıkarsa öğrencilerin Classroom'a geri dönmesi için bir istem OLMALIDIR" ifadesi eklendi.
8.1 "Cihaz desteklenmiyorsa kullanıcıya, cihazın desteklenmeyen bir cihaz olduğunu ve ideal olarak hangi cihazların desteklendiğini bildiren bir mesaj gösterilmesi ZORUNLUDUR."
8.2 Mobil öğrenci çalışmaları GEREKSİNİMDEN ÖNERİLİR olarak değiştirildi.
Sürüm 0.1 Güncelleme tarihi: 22 Eylül 2021
  İlk sürüm.