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 kaynaklara bağlantı içeren ödevler oluşturmak ve notlandırmak için kullanılır. Bu araç, Classroom'da Paylaş düğmelerine kıyasla geliştiricilerin sınıf çalışması yönetimine daha fazla erişmesini 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 ek eklemek için istekte bulunabilirsiniz. Örneğin, Google Drive dosyası veya web sitenizdeki öğrenci çalışmasını gösteren link Material ekleyebilirsiniz.
8. İsteğe bağlı olarak, öğrencinin ödev için notunu ayarlamak üzere courses.courseWork.studentSubmissions.patch hesabına bir 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 ödevi oluşturma ve yönetme ile 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. Örneğin, herhangi bir Google Classroom dersinde değil, yalnızca yetkili kullanıcının ders verdiği derslerde kurs çalışması oluşturabilirsiniz.
• Kullanıcının içeriği almak için bir kurs seçebileceği bir yönteme ihtiyacınız vardır. Kullanıcı tarafından verilen kursların listesini almak için courses.list aracını kullanabilir, ardından kullanıcının listeden bir veya daha fazla kurs seçmesine izin verebilirsiniz.
• 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 durum, geliştiricilerin kursla ilgili bilgilerinin güncelliğini yitirebileceği anlamına gelir. 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.