CourseWork entegrasyonu

Geliştiriciler, Google Classroom'daki kurslarla etkileşimde bulunmak için Google Classroom API'yi kullanabilir. API'yi bu şekilde kullanan uygulamalara CourseWork entegrasyonu denir.

Bu entegrasyon yolu, genellikle Classroom dışındaki kaynakların bağlantılarını içeren ödevler oluşturmak ve notlandırmak için kullanılır. Classroom paylaşım düğmelerine kıyasla geliştiricilere kurs çalışması yönetimine daha fazla erişim sağlar.

İşleyiş şekli

CourseWork entegrasyonunun temel özelliği, Classroom API'yi kullanarak ödev, duyuru ve kurs materyalleri oluşturma ve yönetmedir.

CourseWork entegrasyonunun sağladığı yaygın bir kullanıcı yolculuğu örneği, öğretmenlerin web sitenizden veya uygulamanızdan içerik keşfetmesine, atamasına ve not vermesine olanak tanımaktır:

1. Öğretmen kullanıcı web sitenizde oturum açar.
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 metninde şu bilgileri içeren bir CourseWork nesnesi bulunur:
   • Hedef kurs 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 alınabilecek maksimum puan.
4. Classroom'da bağlantı eki içeren yeni bir ödev görünür. Bağlantı, create isteğinde belirtilen URL'yi ifade eder. Örnek için Şekil 1'e bakın.
5. Classroom not defterinde, ödev için yeni bir sütun da görünür. Bu sütunda, varsa maksimum puan da yer alır.
6. Öğrenciler ödevi alır ve sağlanan URL'yi yeni bir sekmede açmak ve web sitenizdeki içeriği görüntülemek veya tamamlamak için link Material simgesini tıklar. İsteğe bağlı olarak, öğrencinin ödevi teslim etmesi için kontroller sağlayın.
7. İsteğe bağlı olarak, öğrenci gönderimine courses.courseWork.studentSubmissions.modifyAttachments tarafından eklenecek ekler (ör. Google Drive dosyası veya öğrencinin web sitenizdeki çalışmasını gösteren link Material) isteğinde bulunabilirsiniz.
8. İsteğe bağlı olarak, öğrencinin ödevi için notunu belirlemek üzere courses.courseWork.studentSubmissions.patch'a istek gönderin.

Şekil 1. CourseWork entegrasyonu tarafından oluşturulan link Material ile bir ödevi düzenlerken öğretmen görünümü.

Dilerseniz ödev yerine duyuru veya kurs materyali oluşturmak için courses.announcements.create veya courses.courseWorkMaterials.create işlevini de çağırabilirsiniz. İlgili Classroom API işlemlerinin ayrıntılı açıklamaları için Ders programı oluşturma ve yönetme ve Not verme ve güncelleme sayfalarına bakın.

Dikkat edilmesi gereken noktalar

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 rızasını almanız gerekir. Kullanıcı adına API istekleri gönderiyorsunuz. Bu, örneğin, herhangi bir Google Classroom dersinde değil, yalnızca yetkili kullanıcının ders verdiği derslerde kurs çalışması oluşturabileceğiniz anlamına gelir.
• Kullanıcının içeriği almak için bir kurs seçmesi gerekir. Kullanıcının verdiği derslerin listesini almak için courses.list işlevini kullanın ve ardından kullanıcının listeden bir veya daha fazla ders seçmesine izin verin.
• Kullanıcı Classroom'da bir 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.
• Öğretmenler, geliştiriciden bağımsız olarak kurs materyallerini değiştirebilir veya silebilir. Bu nedenle, geliştiricilerin kursla ilgili bilgileri güncelliğini yitirebilir. Derslerdeki değişikliklerden haberdar olmanız gerekiyorsa derslerdeki değişiklikler için push bildirimleri ayarlayabilirsiniz.
• Öğretmenler, web sitenizdeki URL'lerin bağlantılarını yapıştırarak Classroom kullanıcı arayüzünde kurs ödevi oluşturabilir. Bu şekilde oluşturulan kurs çalışmaları 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.