Giriş

Classroom'daki ödevler CourseWork öğeleri olarak adlandırılır ve bunları herhangi bir Classroom dersinin Sınıf Çalışmaları sayfasında bulabilirsiniz. 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ışmaları türlerini nasıl yöneteceğiniz hakkında bilgi edinmek istiyorsanız Sınıf Çalışmaları kılavuzumuzu okuyun.

Google Classroom, ödev iş akışıyla iki şekilde entegre olabilir: Classroom paylaş düğmesi ve Classroom API. Paylaş düğmesi, kullanıcıların Classroom pop-up iletişim kutusu üzerinden herhangi bir akış öğesi gibi içerik paylaşmasına olanak tanırken Classroom API'si ödev oluşturmayı, öğrenci gönderimleri oluşturmayı ve yönetmeyi ve geri verilen notları da içeren uçtan uca ödev iş akışı sağlar.

Burada, bu iki geliştirici teklifi arasındaki temel farkları inceleyeceğiz. Daha net açıklamak gerekirse uygulamadaki farklılıkları ve ödev yaşam döngüsünün her aşamasında (ödev oluşturma, öğrenci gönderimleri ve not verme/geri bildirim) üzerinde çalışacağız.

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

Paylaş düğmesi ile CourseWork API arasındaki farklara geçmeden önce, Classroom bağlamında ödev olarak kabul ettiğimiz yaşam döngüsünü tanımlayalım. Bu, öğretmenlerin ve öğrencilerin Classroom'da ödevlerle nasıl etkileşimde bulunduğunu anlamanıza yardımcı olur.

Classroom ödevleriyle entegrasyon yaparken göz önünde bulundurulması gereken beş ana adım vardır:

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

Classroom ödevleriyle entegrasyon, öğretmen ve öğrencilerin Classroom ile üçüncü taraf uygulamaları arasında sorunsuz bir şekilde çalışmasına olanak tanır. Kullanıcılar, ödev veya öğrenci gönderimleriyle ilgili ayrıntıları yönetmek yerine bu ayrıntıların yönetimi için sizin uygulamanıza güvenebilir.

Ödeve giden beş adımı gösteren şema

Uygulama

Paylaş düğmesi ile CourseWork API arasındaki ilk fark uygulamadır. Geliştiriciler açısından bakıldığında, paylaş düğmesi, Classroom'da içerik paylaşmak için daha kolay bir yöntemdir. Zira, yalnızca gerekli JavaScript kaynağının ve bir "paylaş" düğmesi etiketinin eklenmesi gerekir. Classroom paylaşım düğmesi entegrasyonunuz, en basit haliyle aşağıdaki snippet gibi görünebilir:

<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'nin bir parçasıdır. Bu API, API anahtarlarını Google Cloud Console ile ayarlayıp etkinleştirmeyi ve API ile entegrasyona yönelik en iyi uygulamaları takip etmeyi gerektirir. Platformunuz tanıtım gibi diğer Classroom API işlevlerinden yararlanıyorsa bu durum endişe yaratmanıza gerek kalmaz.

Ödev oluşturma ve paylaşma

Hem paylaş düğmesi hem de CourseWork API, atama iş akışının ilk iki adımını (ödevin oluşturulması ve öğrencilerle paylaşılması) mümkün kılıyor olsa da çözüm seçmeden önce dikkate almanız gereken bazı önemli farklar vardır.

Her iki çözüm de temellerinde Classroom'a ödev olarak bağlantı veya dosya yayınlama olanağı sağlar. Bu, aksi halde Classroom ile üçüncü taraf uygulaması arasında bir kopyalama ve yapıştırma iş akışı yürütmek zorunda kalacak olan öğretmenler için güçlü bir iş akışı işlevi görür. Her iki çözüm de ödev olarak içerik yayınlama özelliğini desteklese de, uygulamanızın bu içeriği diğer Sınıf Çalışmaları türleri veya hatta duyuru olarak yayınlama esnekliğine ihtiyacı olup olmadığını göz önünde bulundurmanız gerekir.

Her iki teklifte de Test Ödevleri hariç tüm Classroom yayın türleri gösterilir. Tüm yayın türlerinin bir özetini ve bunların yayınlanıp yayınlanmadıklarını aşağıda bulabilirsiniz.

Yayın Türü Paylaş düğmesi CourseWork API'si
Ödev X X
Test Ödevi
Question: Kısa Cevap X X
Question: Çoktan seçmeli X X
Malzeme X X
Duyuru X X

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

Atamaları değiştirme

Classroom API ile entegrasyonun avantajlarından biri, kullanıcıların değişen atama ayrıntılarını manuel olarak senkronize etmelerini gerektirme ihtiyacını ortadan kaldırmaktır. Paylaş düğmesi, ödevleri programatik olarak güncelleme veya silme işlevine sahip değildir. Bu yüzden, gerekli değişikliklerin kullanıcı tarafından Classroom kullanıcı arayüzü üzerinden yapılması gerekir.

CourseWork API'yi kullanarak hem uygulamanız tarafından oluşturulan ödevleri değiştirebilir, hem de kullanıcının kurslarında yayınlanan ödevlerin ayrıntılarını alabilirsiniz. Bununla birlikte, aynı geliştirici konsolu tarafından oluşturulmayan CourseWork öğelerinin bu geliştirici konsolu tarafından değiştirilemeyeceğini unutmayın. Bu izin modeli, ödev yaşam döngüsünün geri kalanını (ör. öğrenci gönderimlerini ve notlarını yönetme) kapsar - bu CourseWork öğeleri için erişilemez.

Atamaları otomatik olarak senkronize et

Pub/Sub push bildirimleri sayesinde uygulamanız, CourseWork öğelerinde ve ilişkili öğrenci gönderimlerinde değişiklikler olduğunda bir etkinliği tetikleyen bildirimlere abone olabilir. Bu sayede uygulamanız, içeriklerin Classroom'da 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 ödeve benzersiz bir kimlikle erişilebilir. Bu öğrenci gönderimleri otomatik olarak oluşturulur ve öğrenci gönderimleri GET ve LIST uç noktalarıyla uygulamanız tarafından alınabilir.

Hem paylaş düğmesi hem de CourseWork API, öğrencinin bir ödev gönderimine bağlantı veya dosya eklemeyi destekler. Paylaş düğmesi, bunun için öğretmen ödevi oluşturma iletişim kutusuna benzer bir iş akışı, studentSubmissions.modifyAttachments uç noktası üzerinden ise CourseWork API'yi kullanmanıza olanak tanır. Ancak daha önce açıklanan API izin kısıtlamaları nedeniyle bu işlev, uygulamanızın oluşturduğu CourseWork öğeleriyle sınırlıdır. Aynı kısıtlama, paylaş düğmesi için de geçerli değildir. Öğrenciler, çalışmalarını Classroom'dan seçtikleri herhangi bir ödeve ekleyebilir.

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

CourseWork'ün izin kısıtlaması, ödev oluşturmayı desteklemeyen platformlar için bir kullanım alanına hizmet etmese de öğrencilerin ödevlerini teslim edebilmesi yalnızca paylaş düğmesiyle sınırlı olduğundan, üçüncü taraf platformların hem yanlış ödeve ödev teslim etmesini hem de çalışmalarını teslim etmeyi unutmasını önleyebilmesidir.

Ödevleri inceleme ve not verme

Ödev yaşam döngüsünün son kısmı öğretmene döner. Öğrenciler ödevlerini başarıyla teslim ettikten sonra öğretmenler artık ödevi en uygun şekilde inceleyebilir. Drive'da depolanan dosyaları doğrudan Classroom'daki not veren uygulamasında inceleyebilir. Ancak üçüncü taraf uygulamalarına Classroom'daki not verme aracından erişilemez. Bu deneyimin anlamı, öğretmenlerin ödevleri incelerken ve ödevlere not verirken birden fazla sekmede gezinmesi gerektiğidir.

Paylaş düğmesi, şu an için ödevlere not verme ve ödevleri geri verme konusunda herhangi bir çözüm sunmamaktadır. Öğrenci gönderim yorumları gibi özellikler şu anda API aracılığıyla sunulmasa da, studentSubmissions.patch ve studentSubmissions.return uç noktaları aracılığıyla hem not vermek hem de notları öğrencilere geri vermek mümkündür. Notlar yalnızca CourseWork akışı öğeleri (Ödev ve Soru türleri) için belirtilebilir. Bunlar sadece sayısal biçimdedir ve taslak veya nihai not olarak verilebilir.

Farkların özeti

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

Paylaş Düğmesi CourseWork API'si
Uygulama Yalnızca birkaç satır JavaScript olduğundan, uygulama kolay ve hızlı hale gelir API anahtarlarının ayarlanması, Yönetici Konsolu'nda API'lerin etkinleştirilmesi ve daha yakından izlenmesi gerekir
Ödev Oluşturma ve Paylaşma
  • Öğretmenleri Classroom paylaşım düğmesi paylaşım iletişim kutusuna yönlendirir
  • Kullanıcılar, biri hariç tüm akış öğesi türlerini yayınlayabilir
  • Daha az alan belirtilebilir
  • Biri ödev oluşturmayı etkinleştirir, ödev verilerini alamaz veya değiştiremez
  • Paylaş düğmesi iletişim kutusu gerekli değil
  • Çoğu Classroom ödev alanı belirtilebilir
  • Uygulamanız tarafından oluşturulan sınıf çalışmasını değiştirebilme
  • Uygulamanızın tüm ödev verilerini Classroom'dan 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 ekini etkinleştirir, gönderim verilerini alamaz veya değiştiremez
  • Öğrencilerin ödevi teslim etmesine izin vermez
  • Paylaş düğmesi iletişim kutusu gerekli değil
  • Öğrencilerin, gönderimlerini yalnızca uygulamanız tarafından oluşturulan ödevlere eklemesine izin verir
  • Uygulamanızın, kendisi tarafından oluşturulan öğrenci gönderimlerini değiştirmesine izin verir
  • Öğrencilerin ödevlerini teslim etmesine olanak tanır
Ödevleri İnceleme ve Not Verme Notları belirtme veya geri verme desteği yoktur
  • Uygulamanızın, öğretmen adına Classroom'dan tüm öğrenci gönderim verilerini almasına izin verir
  • Öğrenci notlarını taslak veya final olarak atama özelliğini sunar
  • Öğrenci notlarını değiştirme olanağı sunar
  • Notları öğrencilere geri verme olanağını sunar