Eklerle etkileşimde bulunma

Bu sayfada, ek oluşturma ve öğrenci gönderimleriyle çalışmayla ilgili uygulama ayrıntıları ele alınmaktadır. Bu istekleri gönderirken ekle ilgili parametreler sağlamanız gerekebileceğini unutmayın.

Ek oluşturma

Uygun courses.*.addOnAttachments.create uç noktasına CREATE isteği göndererek ek oluşturun. İsteğiniz, istek metninde AddOnAttachment örneği içermelidir.

Ek oluştururken aşağıdaki alanlar zorunludur:

• title: Ekin dize adı.
• teacherViewUri: Ekin öğretmen görünümünün URI'si.
• studentViewUri: Ekin öğrenci görünümünün URI'si.
• studentWorkReviewUri: Öğretmenin, ekteki öğrenci çalışmasını görebilmesi için URI. Bu alan yalnızca etkinlik türündeki ekler için gereklidir.

Aşağıdaki isteğe bağlı alanlardan bazılarını ekleyebilirsiniz:

• Ekteki son teslim tarihini belirtiyorsanız dueDate ve dueTime.
• maxPoints: Ek için maksimum not. Not aktarımını desteklemek istiyorsanız sıfır olmayan bir değer olmalıdır. Yalnızca etkinlik türündeki ekler için geçerlidir.

Bu alanlar hakkında daha fazla bilgi için AddOnAttachment kaynak referansına bakın.

Öğrenci gönderim ayrıntıları

Tipik bir gönderim iş akışı şu adımları izler:

1. Bir öğrenci, etkinlik tamamlamak için studentViewUri'ü başlatır.
2. Eklenti, öğrenci kimlik bilgilerini kullanarak getAddOnContext yönteminden bir submissionId alır.
3. submissionId ve attachmentId, eklenti geliştiricisi tarafından öğrencinin çalışmasının benzersiz tanımlayıcısı olarak depolanır. Bir öğretmen Classroom'da bir ödevi kopyalarsa kopyalanan ödevde yeni bir ek görüntülemek için bu iki parametrenin birleşik anahtarını kullanabilirsiniz. Daha fazla bilgi için kopyalanan içerik sayfamıza göz atın.
4. Öğrenci çalışmalarını incelemek isteyen bir öğretmen studentWorkReviewUri'ü başlatır. İstek şu sorgu parametrelerini içerir: courseId, itemId, itemType, attachmentId ve submissionId.
5. Eklenti geliştiricisi, öğrenci çalışmalarını almak için bu dört kimliği kullanır. Bir öğrenci gönderimiyle ilgili bilgileri almak veya değiştirmek için courses.courseWork.addOnAttachments.studentSubmissions uç noktasını kullanın.

Gönderim durumunu algılama

Belirli bir submissionId hakkında ayrıntılı bilgi edinmek için courses.courseWork.addOnAttachments.studentSubmissions uç noktasına bir GET isteği gönderin. Gönderimin notunu (pointsEarned) ve mevcut durumunu (postSubmissionState) içeren bir AddOnAttachmentStudentSubmission nesnesi alırsınız. Gönderim durumu aşağıdaki değerlerden biri olabilir:

• Öğrenci gönderime hiç erişmediyse NEW.
• Öğrenci bir gönderim oluşturduysa ancak henüz göndermediyse CREATED.
• TURNED_IN (öğrenci çalışmasını öğretmene gönderdiyse).
• RETURNED (öğretmen gönderimi öğrenciye geri verdiyse).
• Öğrenci ödevini "göndermeyi iptal ettiyse" RECLAIMED_BY_STUDENT.

Eklentilerinizde öğrencinin çalışmasının durumunu algılamak için bu uç noktayı kullanın. Ardından, döndürülen duruma bağlı olarak öğrenciye sunulan görünümleri veya seçenekleri ayarlayabilirsiniz. Bu, aşağıdakiler gibi özellikler içerebilir:

• Eklentinizdeki ödevlerin teslim durumunu görüntüleme. Bu sayede öğrenciler olası karışıklıklardan kaçınabilir ve yanlışlıkla ödev teslim etmeyi unutmazlar.
• Gönderme düzenleme ayrıcalıklarını kısıtlama Ödevin durumu CREATED veya RECLAIMED_BY_STUDENT ise öğrencinin gönderimini düzenlemesine izin verilebilir. Ödevin durumu TURNED_IN veya RETURNED ise öğrencinin gönderimini düzenlemesine izin verilmeyebilir.

Notlar ve birden fazla ek

Tek bir ödevin notunu ayarlamak için yalnızca bir eklenti eki kullanılabilir. Bir öğretmen, maxPoints değeri sağlayan birden fazla etkinlik türü eki oluşturursa yalnızca bu türdeki ilk ek, ödev notunu ayarlayabilir. Bir ek için not aktarımını devre dışı bırakmak üzere maxPoints değerini ayarlanmamış olarak bırakın veya sıfır olarak ayarlayın.

Gönderimin notunu ayarlama

courses.courseWork.addOnAttachments.studentSubmissions uç noktasına bir PATCH isteği göndererek öğrenci gönderimlerini değiştirebilirsiniz. İstek metni, değiştirilmiş değerlere sahip bir AddOnAttachmentStudentSubmission örneği içermelidir. Gönderimin notunu değiştirmek için pointsEarned alanını ayarlayın. pointsEarned parametresinde iletilen değer, Classroom kullanıcı arayüzünde öğretmen tarafından görülebilen bir taslak not olur. Öğretmenler, ödevi öğrencilere geri vermeden önce taslak notu değiştirebilir. Notların öğretmenlere nasıl gösterildiğiyle ilgili ayrıntılar için Classroom kullanıcı arayüzünde not vermeye genel bakış başlıklı makaleyi inceleyin.

Notu pointsEarned ile yalnızca aşağıdaki koşullar geçerliyse ayarlayabileceğinizi unutmayın:

• Ekte pozitif bir maxPoints değeri olmalıdır.
• Eklenti, ekin orijinal oluşturucusu olmalıdır.

Ayrıca, addOnAttachments uç noktasına PATCH isteği göndererek önceden oluşturulmuş bir AddOnAttachment'nin maxPoints değerini değiştirebileceğinizi de unutmayın.

Not ne zaman belirlenir?

Notların ne zaman Google Classroom'a geri aktarılacağı konusunda bazı seçenekleriniz vardır. Notları yalnızca öğretmen değiştirebileceğinden, önemli olan fark, öğretmenin kimlik bilgilerini saklamayı seçip seçmediğinizdir.

Google Classroom'a not ekleyebileceğiniz iki eklenti noktası vardır: Öğrenci çalışmasını tamamladığında veya öğretmen, Öğrenci Çalışması İncelemesi iFrame'sinde öğrencinin çalışmasını açtığında.

Öğrenci çalışmayı tamamladığında not vermek istiyorsanız öğretmenin çevrimdışı kimlik bilgilerini saklamanız, ardından öğrenci çalışmayı tamamladığında notu değiştirmek için bu bilgileri almanız ve kullanmanız gerekir. Bu yöntemin bazı potansiyel avantajları vardır:

• Sorunsuz not güncellemeleri sağlayın. Öğretmenlerin, notların Classroom kullanıcı arayüzünde görünmesi için herhangi bir işlem yapması gerekmez.
• Sınıfın bir ödevdeki ilerleme durumuyla ilgili anlık bilgi verin. Öğretmenler, öğrenciler ekleri tamamladıkça not vererek her gönderimi açmadan öğrencilerinin ne kadar anladığını anlayabilir.

Bu yaklaşımın, not senkronizasyonu için eşzamansız bir yaklaşım da sunduğunu unutmayın. Bir öğrencinin çalışmasını ne zaman gönderdiğini tespit etmek için AddOnAttachmentStudentSubmission uç noktasını düzenli olarak yoklayabilirsiniz. Gönderildikten sonra, depolanan kimlik bilgilerini kullanarak gönderimin notunu ayarlayın.

Öğrenci oturumu sırasında öğretmenin kimlik bilgilerini yüklemek istemiyorsanız Öğrenci Çalışması İncelemesi iframe'inde öğrenci gönderimini yükleyen etkin öğretmenin kimlik bilgilerini kullanabilirsiniz. Ancak Classroom kullanıcı arayüzündeki notlar anlık olarak güncellenmediğinden ve öğretmenlerin her gönderimin Öğrenci Çalışması İncelemesi iframe'ini açması gerektiğinden bu yöntem, özellikle sorunsuz bir kullanıcı deneyimi sağlamayabilir.

Ödev notlarındaki değişiklikleri algılama

Öğretmenler, ödev oluşturulduktan sonra Classroom'da not ayarlarını düzenleyebilir. Bu tür düzenlemeler şunları içerebilir:

• Atanan puan değerini değiştirme.
• Ödevin maxPoints değerini değiştirme
• Ödeve not verilip verilmeyeceğini değiştirme

Bir ödevin mevcut notlandırma ayarlarını görmek için courses.courseWork uç noktasına bir GET isteği göndermenizi öneririz. Yanıt, geçerli maxPoints değerini içerir. Notlandırılmamış ödevler için maxPoints değeri boş veya sıfırdır.

Bir notu Classroom'a geri gönderdiyseniz eklenti eki notunu almak veya değiştirmek için courses.courseWork.addOnAttachments.studentSubmissions uç noktasını kullanın. Not değeri pointsEarned alanı kullanılarak belirlenir. Ürününüz öğretmenlerin belirli bir etkinlik için öğrenci puanlarını düzenlemesine izin veriyorsa bu değeri kontrol edip gerekirse güncelleyebilirsiniz.