CourseWork entegrasyonu

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

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 çalışma materyali 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 sağlanan 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çerikleri 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 adresine istek gönderiyor. İstek, gövdesinde aşağıdaki öğ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'e öğ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'e istek gönderin.

Şekil 1. 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 Çalışma materyali oluşturma ve yönetme ile Notları ayarlama 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 iznini istemeniz gerekir. Kullanıcı adına API istekleri gönderiyorsunuz. Örneğin, herhangi bir Google Classroom kursunda çalışma materyali oluşturamazsınız. Yalnızca yetkili kullanıcının ders verdiği kurslarda çalışma materyali 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.
• Öğretmenler, geliştiriciden bağımsız olarak kurs içeriklerini değiştirebilir veya silebilir. Bu durum, geliştiricilerin kurs materyalleriyle ilgili bilgilerinin güncelliğini yitirmesine neden olabilir. 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 çalışma materyali 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.