Giriş

Classroom'daki ödevlere CourseWork öğeleri adı verilir. Bu öğeleri, herhangi bir Classroom kursunun Sınıf Çalışmaları sayfasında bulabilirsiniz. Dört tür Ödevler öğesi olsa da bu kılavuz yalnızca "Ödev" türüne odaklanmaktadır. Diğer Sınıf Çalışmaları türlerini yönetme hakkında bilgi edinmek istiyorsanız Sınıf Çalışmaları'nı yönetme rehberimizi inceleyin.

Google Classroom'un bir ödev iş akışıyla entegre olmanın 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 ile notları geri aktarma gibi işlemleri içeren uçtan uca bir ödev iş akışı sağlar.

Bu bölümde, bu iki geliştirici teklifi arasındaki temel farkları inceleyeceğiz. Daha ayrıntılı olarak, uygulama ve ödev yaşam döngüsünün her aşamasındaki (ödev oluşturma, öğrenci gönderimleri ve notlandırma/geri bildirim) farklılıkları ele alacağı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 bir ödevin yaşam döngüsü olarak neyi tanımladığımızı açıklayalım. Bu sayede öğretmenlerin ve öğrencilerin Classroom'daki ödevlerle nasıl etkileşim kurduğunu anlayabilirsiniz.

Classroom ödevleriyle entegrasyon yaparken aklınızda bulundurmanız 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 sayesinde öğretmenler ve öğrenciler, Classroom ile üçüncü taraf uygulamaları arasında sorunsuz bir şekilde çalışabilir. Kullanıcılar, ödev veya öğrenci gönderimlerinin ayrıntılarını yönetmek yerine bu ayrıntıları kendileri için yönetmesi konusunda uygulamanıza güvenebilir.

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

Uygulama

Paylaş düğmesi ile CourseWork API arasındaki ilk fark uygulamadır. Geliştirici açısından bakıldığında, paylaş düğmesi yalnızca gerekli JavaScript kaynağının eklenmesini ve bir paylaş düğmesi etiketinin eklenmesini gerektirdiğinden içeriği Classroom'da paylaşmak için daha kolay bir yöntemdir. En basit haliyle, Classroom paylaşım düğmesi entegrasyonunuz 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>

Diğer yandan CourseWork API, Google Classroom API REST API'nin bir parçasıdır. Bu API'nin kullanılması için Google Cloud Console ile API anahtarlarının ayarlanması ve etkinleştirilmesi, ayrıca bir API ile entegrasyon için en iyi uygulamaların izlenmesi gerekir. Platformunuz zaten rostering gibi diğer Classroom API işlevlerinden yararlanıyorsa bu durum daha az sorun teşkil eder.

Ödev oluşturma ve paylaşma

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

Her iki çözüm de temel olarak bağlantıların veya dosyaların Classroom'da ödev olarak yayınlanmasına olanak tanır. Bu özellik, Classroom ile üçüncü taraf uygulaması arasında kopyalama ve yapıştırma iş akışını kullanmak zorunda kalacak öğretmenler için güçlü bir iş akışı sağlar. Her iki çözüm de içeriklerin ödev olarak yayınlanmasını desteklese de uygulamanızın bu içerikleri diğer Sınıf Çalışması türleri veya duyuru olarak yayınlama esnekliğine ihtiyacı olup olmadığını göz önünde bulundurmanız gerekir.

Her iki teklif de Sınav Ö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
Quiz Assignment
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ş düğmesi entegrasyonu, kullanıcıların son tarih, konu, kişiselleştirilmiş mod ve puan sayısı gibi alanları pop-up iletişim kutusunda ayarlamasına olanak tanır ancak bu alanlar üçüncü taraf bir uygulama tarafından programatik olarak ayarlanamaz. API ise tüm bu alanları hem okuma hem de yazma erişimi için kullanıma sunar.

Ödevleri değiştirme

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

CourseWork API, uygulamanızın oluşturduğu ödevleri değiştirme ve silme olanağının yanı sıra kullanıcının kurslarına gönderilen ödevlerin ayrıntılarını alma olanağı da sunar. Ancak 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, ödevin yaşam döngüsünün geri kalanını da kapsar.Örneğin, öğrenci gönderimleri ve notları yönetilemez. Bu CourseWork öğelerine erişilemez.

Ödevleri otomatik olarak senkronize etme

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

Ö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şkilendirilmiş bir öğrenci gönderimi vardır. Bu gönderime 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şma düğmesi hem de CourseWork API, ödev için öğrenci gönderimine bağlantı veya dosya eklemeyi destekler. Paylaş düğmesi, öğretmen ödev oluşturma iletişim kutusuna benzer bir iş akışıyla, CourseWork API ise studentSubmissions.modifyAttachments uç noktası aracılığıyla buna olanak tanır. Ancak daha önce ayrıntılı olarak açıklanan API izni 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şma düğmesi için geçerli değildir. Öğrenciler, çalışmalarını Classroom'da seçtikleri herhangi bir ödeve ekleyebilir.

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

CourseWork izni kısıtlaması, ödev oluşturmayı desteklemeyen platformlarda bir kullanım alanına sahip olmasa da bir avantajı, üçüncü taraf platformların öğrencilerin yanlış ödeve göndermesini ve çalışmalarını teslim etmeyi unutmasını önleyebilmesidir. Bunun nedeni, öğrencilerin ödevlerini teslim etme özelliğinin yalnızca paylaş düğmesiyle sınırlı olmasıdır.

Ö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 üçüncü taraf uygulamalarına Classroom notlandırma aracında erişilemez. Bu deneyimin sonucu olarak öğretmenler, ödevleri incelerken ve notlandırırken birden fazla sekmede gezinmek zorunda kalıyor.

Paylaş düğmesi şu anda ödevleri notlandırma ve geri gönderme konusunda bir çözüm sunmamaktadır. Öğrenci gönderim yorumları gibi özellikler şu anda API üzerinden kullanılamasa da studentSubmissions.patch ve studentSubmissions.return uç noktaları aracılığıyla hem not verme hem de bu notları öğrencilere geri verme işlemleri yapılabilir. Notlar yalnızca CourseWork 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.

Başlıca farklar

Ö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ş düğmesi ile CourseWork API'nin yan yana karşılaştırması gösterilmektedir.

Paylaş Düğmesi CourseWork API
Uygulama Yalnızca birkaç satır JavaScript kodu içerdiğinden kolay ve hızlı bir şekilde uygulanabilir. API anahtarlarının ayarlanması, Yönetici Konsolu'nda API'lerin etkinleştirilmesi ve daha yakından izleme gerekir.
Ö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ış öğesi türlerini yayınlayabilir.
  • Daha az alan belirtilebilir
  • Biri ödev oluşturmaya olanak tanır, ödev verilerini çekme veya değiştirme özelliği yoktur.
  • Gerekli paylaşım düğmesi iletişim kutusu yok
  • Çoğu Classroom ödev alanı belirtilebilir.
  • Uygulamanız tarafından oluşturulan kurs içeriklerini değiştirme
  • Uygulamanızın Classroom'daki tüm ödev verilerini çekmesine olanak tanır.
Ö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 çekme veya değiştirme özelliği yoktur.
  • Öğrencilerin ödevi teslim etmesine izin vermez.
  • Gerekli paylaşım düğmesi iletişim kutusu yok
  • Öğ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 Not Verme Not belirtme veya döndürme desteği yok
  • Uygulamanızın, bir öğretmen adına Classroom'daki tüm öğrenci gönderim verilerini çekmesine izin verir.
  • Öğrenci notlarını taslak veya nihai olarak atama özelliğini kullanıma sunar.
  • Öğrenci notlarını değiştirme olanağı sunar.
  • Notları öğrencilere geri verme özelliğini kullanıma sunar.