CourseWork entegrasyonu

Geliştiriciler, Google Classroom'daki kurs içerikleriyle etkileşim kurmak için Google Classroom API'yi kullanabilir. API'yi bu şekilde kullanan uygulamalara CourseWork entegrasyonu adı verilir.

Önemli Nokta: CourseWork entegrasyonu, geliştiricilerin Google Classroom duyurularının, kurs materyallerinin, ödevlerin ve öğrenci gönderimlerinin durumuna programatik olarak erişip bunları değiştirmesine olanak tanır. İçeriğinizi Classroom'a aktarmanın düşük maliyetli bir yolunu arıyorsanız bu yolu seçin.

Bu entegrasyon yolu, Classroom dışındaki kaynaklara bağlantılar içeren ödevler oluşturmak ve notlandırmak için yaygın olarak kullanılır. Classroom'da Paylaş düğmelerine kıyasla kurs yönetimine daha fazla geliştirici erişimi sağlar.

İşleyiş şekli

CourseWork entegrasyonunun temel özelliği, Classroom API kullanılarak ödevlerin, duyuruların ve kurs materyallerinin oluşturulması ve yönetilmesidir.

CourseWork entegrasyonuyla etkinleştirilen yaygın bir kullanıcı yolculuğu örneği, öğretmenlerin web sitenizdeki veya uygulamanızdaki içerikleri keşfetmesine, atamasına ve notlandırmasına olanak tanımaktır:

1. Bir öğretmen kullanıcısı web sitenize giriş yapar.
2. Öğretmen, sınıfıyla paylaşmak istediği içeriği bulur veya oluşturur. Öğretmen, bu içeriği Google Classroom'a göndermek için web sitenizdeki bir düğmeyi tıklar.
3. Uygulamanız courses.courseWork.create için istek gönderiyor. İstek, gövdesinde şu öğeleri içeren bir CourseWork nesnesi içeriyor:
   • Hedef kursun kimliği.
   • Ödevin başlığı.
   • Ödevin metin açıklaması.
   • Öğretmen tarafından seçilen içeriğin URL'sini içeren bir link Material.
   • İsteğe bağlı olarak, seçilen içerik için elde edilebilecek maksimum puan.
4. Classroom'da bağlantı eki içeren yeni bir ödev gösterilir. Bağlantı, create isteğinde belirtilen URL'yi ifade eder. Örnek için Şekil 1'e bakın.
5. Ödev için yeni bir sütun da Classroom not defterinde görünür. Bu sütunda, varsa maksimum puan da yer alır.
6. Öğrenciler ödevi alır ve link Material simgesini tıklayarak sağlanan URL'yi yeni bir sekmede açıp web sitenizdeki içeriği görüntüleyebilir veya tamamlayabilir. İsteğe bağlı olarak, öğrencinin ödevi teslim etmesi için kontroller sağlayın.
7. İsteğe bağlı olarak, courses.courseWork.studentSubmissions.modifyAttachments'a öğrenci gönderimine ek ekleme isteği gönderin. Örneğin, Google Drive dosyası veya web sitenizdeki öğrenci çalışmasına yönlendiren link Material.
8. İsteğe bağlı olarak, öğrencinin ödev notunu ayarlamak için courses.courseWork.studentSubmissions.patch isteğinde bulunun.

1.şekil link Material CourseWork entegrasyonuyla oluşturulan bir ödevi düzenlerken öğretmen görünümü.

Alternatif olarak, ödev yerine duyuru veya kurs materyali oluşturmak için courses.announcements.create ya da courses.courseWorkMaterials.create numaralarını arayabilirsiniz. İlgili Classroom API işlemleriyle ilgili ayrıntılı açıklamalar için Kurs içeriği oluşturma ve yönetme ile Notları ayarlama ve güncelleme sayfalarına bakın.

Dikkat edilmesi gereken noktalar

Önemli Nokta: CourseWork entegrasyonuyla ilgili bazı önemli sınırlamalar vardır. Bu kısıtlamalar ürününüzü kullanıma sunmanızı engelliyorsa bunun yerine Google Classroom eklentisi oluşturmayı düşünebilirsiniz.

CourseWork entegrasyonunun ürün ihtiyaçlarınız için doğru seçim olup olmadığına karar vermeden önce aşağıdakileri göz önünde bulundurun.

• Kullanıcıyı yetkilendirmeniz ve kullanıcının iznini istemeniz gerekir. Kullanıcı adına API istekleri gönderiyorsunuz. Örneğin, herhangi bir Google Classroom kursunda ödev oluşturamazsınız. Yalnızca yetkili kullanıcının ders verdiği kurslarda ödev oluşturabilirsiniz.
• Kullanıcının içeriği alacağı kursu seçebilmesi gerekir. Kullanıcının verdiği derslerin listesini almak için courses.list'ı kullanın. Ardından, kullanıcının listeden bir veya daha fazla ders seçmesine izin verin.
• Kullanıcı Classroom'da link Material simgesini tıkladığında bağlantı yeni bir sekmede açılır. URL açıldığında sunucunuz Classroom'dan herhangi bir bilgi almaz.
• Öğretmen, kurs içeriğini geliştiriciden bağımsız olarak değiştirebilir veya silebilir. Bu nedenle, geliştiricilerin kurs içeriğiyle ilgili bilgileri güncelliğini yitirebilir. Kurs materyallerindeki değişikliklerden haberdar olmanız gerekiyorsa kurs materyallerindeki değişiklikler için push bildirimleri ayarlayabilirsiniz.
• Öğretmenler, Classroom kullanıcı arayüzünde web sitenizdeki URL'lere yapıştırılmış bağlantılar içeren ödevler oluşturabilir. Bu şekilde oluşturulan ders materyalleri yalnızca öğretmene aittir. Bu nedenle, Classroom API'yi kullanarak gönderim notlarını görüntüleyemez, değiştiremez veya ayarlayamazsınız.