Bu sayfada, Classroom eklentinizi tasarlarken ve uygularken dikkate almanız gereken bazı yaygın yanlış anlaşılmalar ve uç durumlar listelenmiştir. Bu durumları kapsayan hata güvenliklerini ve testleri uygulamanız önerilir.
Google Classroom kavramları
Bu bölümde, Google Classroom'un tamamında geçerli olan eklentilerle ilgili uç örnekler ve kavramlar vurgulanır.
Kurslar ve kullanıcı rolleri
Ders, öğretmenleri öğrencileri birbirine bağlayan merkezi bir kuruluş birimidir. Kurslar, Google Classroom API'deki en üst düzey organizasyondur.
Tek tek kullanıcılar, kursa "öğretmen" veya "öğrenci" olarak eklenebilir. Kullanıcının kurstaki rolü, kurumundaki rolüne bağlı değildir. Yani okulun öğrenci üyeleri bir derste öğretmen olabilir ve öğretmen üyeleri derslerde öğrenci olabilir. Kurslar genellikle düzenli olarak planlanmış akademik konuları temsil etmek için oluşturulsa da öğrenci kulüpleri düzenlemek veya mesleki gelişim sağlamak için de oluşturulabilir.
Aşağıdakiler Google Classroom'daki tüm kurslar için geçerlidir.
Kurs öğretmenleri ile ilgili:
- Bir kursta birden fazla öğretmen olabilir.
- Öğretmenler diledikleri zaman derslere eklenebilir.
- Öğretmenler diledikleri zaman kurstan çıkarılabilir.
Akış öğesi
Akış öğeleri, bir kursun üyeleriyle paylaşılan, yayınlanan içerik parçalarıdır. Geliştiriciler ve öğretmenler üç akış öğesi türünde eklenti ekleri oluşturabilir: duyurular, ödevler ve materyaller.
Öğretmenler, Classroom kullanıcı arayüzündeki Akış sayfasının en üstünden duyuru oluşturur. Öğretmenler, sınıf çalışmaları sekmesindeki Oluştur düğmesini tıklayarak ödev ve materyal oluşturur. Geliştiriciler bunları Classroom API aracılığıyla programatik olarak oluşturabilir.
Ödev, öğrenci gönderimlerini kabul edebilen bir akış öğesidir. Ödevler, not defterinde görünen ve eklenti eki içerebilen tek akış öğesidir.
Akış öğeleri ile ilgili olarak:
- Ödev veya materyaller, kurstaki öğrencilerin bir alt kümesine atanabilir.
- Ödevlere not verilebilir veya not verilmeyebilir. Öğretmenler, ödevlerin notlandırma durumunu istedikleri zaman değiştirebilir.
- Bir ödevde birden fazla ek olabilir.
- Ödevlerde farklı türde ekler bulunabilir. Örneğin, bir ödevde aynı anda Google Dokümanlar, YouTube videoları ve eklenti ekleri bulunabilir.
- Bir ödevde birden fazla geliştiricinin eklenti ekleri olabilir.
- Geliştiriciler, eklenti eklerinden biriyle herhangi bir akış öğesiyle ilgili bilgileri alabilir ve değiştirebilir.
- Geliştiriciler, eklenti eklerinden birini içeren bir ödev için öğrenci gönderimini teslim edebilir, geri alabilir veya iade edebilir.
- Geliştiriciler, oluşturdukları ödevlerde yalnızca öğrencilerin gönderimleri için not ayarlayabilir.
Akış öğeleri kopyalandı
Öğretmenler, bir dersi kopyalayarak, ödevi yeniden kullanarak veya yayın öğesini birden fazla derse yayınlayarak yayın öğelerini kopyalayabilir. Eklentinin bu senaryoları nasıl ele alabildiğini anlamak için kopyalanan içerik ile ilgili kılavuzumuzu okuyun.
Kullanıcının kurumu
Google Classroom API, kullanıcının kurumu, binası veya kurs düzeyinin üzerindeki diğer üyelikleri için tanımlayıcı döndürmez.