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ıdır.
• teacherViewUri: Ekin öğretmen görünümünün URI'si.
• studentViewUri: Ekin Öğrenci Görünümü için URI.
• studentWorkReviewUri: öğretmenin, öğrencinin ek üzerindeki çalışmasını görebileceği 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. Notların sisteme geri gönderilmesini 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.

Öğrencinin 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, öğrencinin çalışmasının benzersiz tanımlayıcısı olarak eklenti geliştiricisi tarafından depolanır. Öğretmenin Classroom'da bir ödevi kopyalaması durumunda, bu iki parametrenin birleşik anahtarını kullanarak, kopyalanan ödevde yeni bir ek görüntüleyebilirsiniz. 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 ile ilgili ayrıntıları almak 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.
• Öğrenci, çalışmasını öğretmene gönderdiyse TURNED_IN.
• Öğretmen ödevi öğrenciye geri verdiyse RETURNED.
• Öğrenci, çalışmasını "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 ödevlerini yanlışlıkla teslim etmeyi unutmazlar.
• Gönderme düzenleme ayrıcalıklarını kısıtlama Ödev CREATED veya RECLAIMED_BY_STUDENT durumuna sahipse öğrenci, gönderimini düzenleme iznine sahip olabilir. Ö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 ödev notunu yalnızca bu tür ilk ek belirleyebilir. 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 geçici notu değiştirebilir. Öğretmenlere notların nasıl sunulduğuyla ilgili ayrıntılar için Classroom kullanıcı arayüzünde not vermeye genel bakış başlıklı makaleyi inceleyin.

Yalnızca aşağıdakiler doğruysa pointsEarned ile not 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.

Ne zaman not vermelisiniz?

Notların Google Classroom'a ne zaman geri aktarılacağına ilişkin tercihte bulunabilirsiniz. Notları yalnızca öğretmen değiştirebileceğinden, önemli olan fark, öğretmenin kimlik bilgilerini saklamayı seçip seçmediğinizdir.

Google Classroom'a not verebileceğiniz iki eklenti anı vardır: öğrenci çalışmasını tamamladığında veya öğretmenin Öğrenci Çalışması İncelemesi iframe'inde ç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 ödevdeki ilerleme durumuyla ilgili gerçek zamanlı analiz sağlama. Öğ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 yaklaşıma da olanak tanıdığını 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 etkin öğretmen, Öğrenci Çalışması İncelemesi iframe'ine öğrencinin gönderimini yüklediğinde öğ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, mevcut 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 puanını düzenlemesine izin veriyorsa bu değeri kontrol edip gerekirse güncelleyebilirsiniz.