Giriş

Classroom'daki ödevler, Kurs Çalışması öğeleri olarak adlandırılır ve herhangi bir Classroom kursunun Sınıf Çalışmaları sayfasında bulunabilir. Dört sınıf çalışması öğe türü olsa da bu kılavuzda yalnızca "Ödev" türü ele alınmaktadır. Diğer sınıf çalışması türlerini nasıl yöneteceğiniz hakkında bilgi edinmek için Sınıf çalışmalarını yönetme rehberimizi okuyun.

Google Classroom'u ödev iş akışına entegre etmenin iki yolu vardır: Classroom paylaşım düğmesi ve Classroom API. Paylaş düğmesi, kullanıcıların Classroom pop-up iletişim kutusu aracılığıyla içerikleri herhangi bir akış öğesi olarak paylaşmasına olanak tanır. Classroom API ise ödev oluşturma, öğrenci gönderimlerini oluşturma ve yönetme ve notları geri gönderme gibi işlemleri kapsayan baştan sona bir ödev iş akışı sağlar.

Bu iki geliştirici teklifi arasındaki temel farkları burada inceleyeceğiz. Daha ayrıntılı olarak belirtmek gerekirse, uygulamadaki farklılıkları ve ödev yaşam döngüsünün her aşamasını (ödev oluşturma, öğrenci gönderimleri ve notlandırma/geri bildirim) ele alacağız.

Ödev yaşam döngüsünü anlama

Paylaşım düğmesi ile CourseWork API arasındaki farklara geçmeden önce, Classroom bağlamında bir ödevin yaşam döngüsü olarak neyi kabul ettiğimizi tanımlayalım. Bu sayede, öğretmenlerin ve öğrencilerin Classroom'daki ödevlerle nasıl etkileşimde bulunduğunu anlayabilirsiniz.

Classroom ödevleriyle entegrasyon sırasında dikkat etmeniz gereken beş ana adım vardır:

  1. Ödev oluşturulur.
  2. Ödev öğrencilerle paylaşılır.
  3. Öğrenci ödevi tamamlar.
  4. Öğrenci ödevi öğretmene gönderir.
  5. Öğretmen, ödevleri inceler ve not verir.

Classroom ödevleriyle entegrasyon, öğretmenler ve öğrencilerin Classroom ile üçüncü taraf uygulamaları arasında sorunsuz bir şekilde çalışmasını sağlar. Kullanıcılar, ödev veya öğrenci gönderimlerinin ayrıntılarını yönetmek yerine bu ayrıntıları uygulamanızın yönetmesine güvenebilir.

Ödevin beş adımını gösteren şema

Uygulama

Paylaşım düğmesi ile CourseWork API arasındaki ilk fark uygulamadır. Geliştirici açısından bakıldığında, Classroom'da içerik paylaşmak için paylaş düğmesi daha kolay bir yöntemdir. Bunun için yalnızca gerekli JavaScript kaynağını ve paylaş düğmesi etiketini eklemeniz gerekir. Classroom paylaşım düğmesi entegrasyonunuzun en basit hali aşağıdaki snippet'e benzeyebilir:

<script src="https://apis.google.com/js/platform.js" async defer></script>
<g:sharetoclassroom url="http://url-to-share" size="32"></g:sharetoclassroom>

Öte yandan CourseWork API, Google Classroom API REST API'sinin bir parçasıdır. Bu API'yi kullanmak için Google Cloud Console'da API anahtarlarını oluşturmanız ve etkinleştirmeniz, ayrıca API ile entegrasyonla ilgili en iyi uygulamaları uygulamanız gerekir. Platformunuz halihazırda disiplin listesi gibi diğer Classroom API işlevlerinden yararlanıyorsa bu durum daha az endişe vericidir.

Ödev oluşturma ve paylaşma

Hem paylaşım düğmesi hem de CourseWork API, ödev iş akışının ilk iki adımını (ödevi oluşturma ve öğrencilerle paylaşma) sağlar. Ancak bir çözüm seçmeden önce dikkate almanız gereken bazı önemli farklılıklar vardır.

Her iki çözüm de temel olarak, Classroom'da bağlantı veya dosya yayınlama olanağı sunar. Bu, Classroom ile üçüncü taraf uygulaması arasında kopyalama ve yapıştırma işlemi yapmak zorunda kalan öğretmenler için güçlü bir iş akışı sağlar. Her iki çözüm de içeriği ödev olarak yayınlama özelliğini desteklese de uygulamanızın bu içeriği diğer sınıf çalışması türleri veya hatta duyuru olarak yayınlama esnekliğine ihtiyacı olup olmadığını göz önünde bulundurmanız gerekir.

Her iki teklif de test ödevleri hariç tüm Classroom gönderi türlerini gösterir. Tüm gönderi türlerinin ve bunların gösterilip gösterilmediğinin özetini aşağıda bulabilirsiniz.

Gönderi Türü Paylaş düğmesi CourseWork API
Ödev X X
Test Ödevi
Soru: Kısa Yanıt X X
Soru: Çoktan Seçmeli X X
Malzeme X X
Duyuru X X

Başlık ve açıklama belirtme gibi işlevler, her iki çözüm için de uygulamanız tarafından programatik olarak belirtilebilir. Paylaşım düğmesi entegrasyonu, kullanıcıların pop-up iletişim kutusunda son tarih, konu, kişiselleştirilmiş mod ve puan sayısı gibi alanları ayarlamalarına olanak tanır. Ancak bu alanlar üçüncü taraf uygulamaları tarafından programatik olarak ayarlanamaz. Öte yandan API, bu alanların tümünü hem okuma hem de yazma erişimi için gösterir.

Ödevleri değiştirme

Classroom API ile entegrasyon, kullanıcıların ödevlerindeki değişen ayrıntıları manuel olarak senkronize etme ihtiyacını ortadan kaldırır. Paylaşım düğmesinde, ödevleri programatik olarak güncelleme veya silme işlevi yoktur. Bu nedenle, gerekli tüm değişikliklerin kullanıcı tarafından Classroom kullanıcı arayüzü üzerinden yapılması gerekir.

CourseWork API, hem uygulamanızın oluşturduğu ödevleri değiştirme ve silme hem de kullanıcının kurslarına gönderilen ödevlerin ayrıntılarını alma olanağı sunar. Ancak aynı geliştirici konsolu tarafından oluşturulmayan Ödev öğelerinin ilgili geliştirici konsolu tarafından değiştirilemeyeceğini unutmayın. Bu izin modeli, ödev yaşam döngüsünün geri kalanına da uygulanır. Örneğin, bu CourseWork öğelerinde öğrenci gönderimleri ve notları yönetilemez.

Ödevleri otomatik olarak senkronize etme

Pub/Sub push bildirimleriyle uygulamanız, CourseWork öğelerinde ve ilişkili öğrenci gönderimlerinde değişiklik olduğunda bir etkinliği tetikleyen bildirimlere abone olabilir. Bu sayede, uygulamanız Classroom'da içeriğin güncellenip güncellenmediğini sürekli olarak kontrol etme ihtiyacını ortadan kaldırarak ödevleri kolayca senkronize edebilir.

Ödevleri tamamlama ve gönderme

Her ödev, N öğrenci gönderimiyle ilişkilendirilir. Burada N, ödevin atandığı öğrenci sayısıdır. Diğer bir deyişle, her ödev için her öğrenciyle ilişkili bir öğrenci gönderimi vardır. Bu gönderime benzersiz bir kimlikle erişilebilir. Bu öğrenci gönderimleri otomatik olarak oluşturulur ve uygulamanız tarafından öğrenci gönderimleri GET ve LIST uç noktalarıyla alınabilir.

Hem paylaşım düğmesi hem de CourseWork API, öğrencilerin ödev gönderimlerine bağlantı veya dosya eklemeyi destekler. Paylaş düğmesi, öğretmen ödevi oluşturma iletişim kutusuyla benzer bir iş akışı ve CourseWork API'nin studentSubmissions.modifyAttachments uç noktası aracılığıyla bu işlemi gerçekleştirmenize olanak tanır. Ancak daha önce ayrıntılı olarak açıklanan API izin kısıtlamaları nedeniyle bu işlev, uygulamanızın oluşturduğu CourseWork öğeleriyle sınırlıdır. Paylaş düğmesi için aynı kısıtlama geçerli değildir. Öğrenciler, çalışmalarını Classroom'dan seçtikleri herhangi bir ödeve ekleyebilir.

Öğrenci iş akışını sonlandırma

Ödev oluşturmayı desteklemeyen platformlar için CourseWork izin kısıtlaması bir kullanım alanı sunmasa da üçüncü taraf platformlar, öğrencilerin ödevlerini gönderme özelliği yalnızca paylaşım düğmesiyle sınırlı olduğundan öğrencilerin hem yanlış ödevi göndermesini hem de çalışmalarını göndermeyi unutmasını önleyebilir.

Ödevleri inceleme ve notlandırma

Ödev yaşam döngüsünün son kısmı öğretmene geri döner. Öğrenciler ödevlerini başarıyla teslim ettikten sonra öğretmen, ödevi en uygun şekilde inceleyebilir. Drive'da depolanan dosyaları doğrudan Classroom not verme aracında inceleyebilirler. Ancak Classroom notlandırıcısında üçüncü taraf uygulamalarına erişilemez. Bu deneyimin sonucu olarak, öğretmenler ödevleri incelerken ve not verirken birden fazla sekme arasında gezinmek zorunda kalıyor.

Paylaşım düğmesi şu anda ödevleri notlandırma ve geri gönderme için bir çözüm sunmamaktadır. Öğrenci gönderimi yorumları gibi özellikler şu anda API üzerinden sunulmasa da studentSubmissions.patch ve studentSubmissions.return uç noktaları aracılığıyla hem not verebilir hem de bu notları öğrencilere döndürebilirsiniz. Notlar yalnızca Ödev Akışı öğeleri (Ödev ve Soru türleri) için belirtilebilir. Yalnızca sayısal biçimde kullanılabilir ve taslak veya nihai not olarak atanabilir.

Farklılıkların özeti

Önceki bölümlerde incelenen her şeyi özetlemek için aşağıdaki tabloda, yukarıda bahsedilen dört kategori (uygulama, ödev oluşturma ve paylaşma, ödevleri tamamlama ve gönderme, ödevleri inceleme ve notlandırma) için paylaşma düğmesi ile CourseWork API'nin yan yana karşılaştırması gösterilmektedir.

Paylaş Düğmesi CourseWork API
Uygulama Uygulamayı kolay ve hızlı hale getiren yalnızca birkaç satır JavaScript API anahtarlarının ayarlanması, API'lerin Yönetici Konsolu'nda etkinleştirilmesi ve daha sıkı izleme gerektirir
Ödev Oluşturma ve Paylaşma
  • Öğretmenleri Classroom paylaşım düğmesi paylaşım iletişim kutusuna yönlendirir.
  • Kullanıcılar, bir akış öğesi türü hariç tüm akış öğelerini yayınlayabilir
  • Daha az alan belirtilebilir
  • Biri ödev oluşturmayı sağlar, ödev verilerini alma veya değiştirme olanağı yoktur
  • Paylaş düğmesi gerekmez iletişim kutusu
  • Çoğu Classroom ödevi alanı belirtilebilir
  • Uygulamanız tarafından oluşturulan dersleri değiştirme olanağı
  • Uygulamanızın Classroom'daki tüm ödev verilerini almasına izin verir
Ödevleri Tamamlama ve Gönderme
  • Öğrencileri Classroom paylaşım düğmesi paylaşım iletişim kutusuna yönlendirir.
  • Öğrencilerin gönderimlerini herhangi bir Classroom ödevine eklemesine olanak tanır.
  • Biri gönderim eki sağlar, gönderim verilerini alma veya değiştirme olanağı yoktur
  • Öğrencilerin ödevi teslim etmesine izin vermez
  • Paylaş düğmesi gerekmez iletişim kutusu
  • Öğrencilerin yalnızca uygulamanız tarafından oluşturulan ödevlere gönderimlerini eklemesine izin verir.
  • Uygulamanızın, uygulamanız tarafından oluşturulan öğrenci gönderimlerini değiştirmesine izin verir
  • Öğrencilerin ödevlerini teslim etmesine olanak tanır
Ödevleri İnceleme ve Notlandırma Not belirtme veya döndürme desteği yoktur.
  • Uygulamanızın, bir öğretmen adına Classroom'dan tüm öğrenci gönderim verilerini almasına izin verir.
  • Öğrenci notlarını taslak veya nihai olarak atama olanağı sunar
  • Öğrenci notlarını değiştirme olanağı sunar
  • Öğrencilere notları geri verme özelliğini gösterir