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:
- Ödev oluşturuldu.
- Ödev öğrencilerle paylaşıldı.
- Öğrenci ödevi tamamlar.
- Öğrenci, ödevi öğretmene gönderir.
- Öğ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.
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 |
|
|
Ödevleri Tamamlama ve Gönderme |
|
|
Ödevleri İnceleme ve Not Verme | Notları belirtme veya geri verme desteği yoktur |
|