Göz önünde bulundurulması gereken önemli noktalar

Bu sayfada, Classroom eklentinizi tasarlayıp uygularken göz önünde bulundurmak isteyebileceğiniz bazı yaygın yanlış anlamalar 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.

Dersler ve kullanıcı rolleri

Kurs, öğretmenler ile öğrenciler arasında bağlantı kuran merkezi kuruluş birimidir. Dersler, Google Classroom API'deki en üst düzey organizasyondur.

Derslere tek tek kullanıcılar "öğretmen" veya "öğrenci" olarak eklenebilir. Kullanıcının kurstaki rolü, kurumundaki rolüne bağlı değildir. Bu, okulun bir öğrencisinin derste öğretmen olabileceği ve öğretmen üyeleri de derslerde öğrenci olabileceği anlamına gelir. En yaygın durum, düzenli olarak planlanmış akademik bir konunun gösterilmesidir. Kurslar, öğrenci kulüplerini düzenlemek veya mesleki gelişimi yürütmek için de oluşturulur.

Aşağıdaki bilgiler Google Classroom'daki tüm dersler için geçerlidir.

Derslerin öğretmenleri ile ilgili olarak:

  • Bir derste birden fazla öğretmen olabilir.
  • Öğretmenler bir derse herhangi bir zamanda eklenebilir.
  • Öğretmenler derslerden herhangi bir zamanda çıkarılabilir.

Akış öğesi

Akış öğeleri, bir dersin ü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 üst kısmında duyurular oluşturabilir. Öğretmenler, Sınıf Çalışmaları sekmesindeki Oluştur düğmesini tıklayarak ödev ve materyal oluşturabilir. Geliştiriciler bunları Classroom API üzerinden programatik olarak oluşturabilir.

Ödev, öğrencinin gönderimini kabul edebilen bir akış öğesidir. Ödevler, not defterinde eklenti eki bulunabilen tek akış öğesi türüdür.

Akış öğeleri ile ilgili olarak:

  • Bir ödev veya materyal, kurstaki öğrencilerin bir alt kümesine atanabilir.
  • Ödeve not verilmiş veya verilmemiş olabilir. Öğretmenler, ödevin notlandırma durumunu istedikleri zaman değiştirebilir.
  • Bir ödevde birden fazla ek olabilir.
  • Ödevlerde farklı türde ekler olabilir. Örneğin, bir ödevde Google Dokümanlar, YouTube videoları ve eklenti ekleri aynı anda bulunabilir.
  • Bir ödevde birden fazla geliştiriciden eklenti ekleri olabilir.
  • Geliştiriciler, eklenti eklerinden birini kullanarak 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 geri verebilir.
  • Geliştiriciler yalnızca kendi oluşturdukları ödevlerdeki her bir öğrenci gönderimi için not belirleyebilir.

Akış öğeleri kopyalandı

Öğretmenler bir dersi kopyalayarak, ödevi yeniden kullanarak veya bir akış öğesini birden fazla derste yayınlayarak bir akış öğesini kopyalayabilir. Eklentinin bu senaryolarla nasıl başa çıkabileceğini anlamak için kopyalanan içerik ile ilgili kılavuzumuzu okuyun.

Kullanıcının kurumu

Google Classroom API; bir kullanıcının kurumu, yapısı veya ders düzeyinin üzerindeki başka bir üyelikle ilgili tanımlayıcıları döndürmez.