Notlar

Bu belgede, Classroom API ile ilgili notlandırma kavramları tanıtılmaktadır.

Google Classroom uygulamasında öğretmenlerin not verme yolculukları hakkında bilgi edinmek için ödevlere not verme ve izleme makalesine bakın.

Sınıf çalışmaları ve gönderimler

Google Classroom'da öğrenciler, Course kapsamındaki CourseWork ödevleri için StudentSubmissions teslim eder. CourseWork için not verilebilir veya not verilmeyebilir. Puan verilen CourseWork öğelerinin maxPoints değeri vardır. Bu değer, ödevin toplam puanını gösterir. maxPoints sıfır ise veya belirtilmemişse ödeve not verilmez.

Öğretmenler, not verilmiş ödevleri öğrenciye geri vermeden önce StudentSubmission için draftGrade not verir. Gönderim Classroom uygulamasında döndürüldüğünde, StudentSubmission üzerinde mevcut draftGrade ile aynı değere sahip bir assignedGrade otomatik olarak ayarlanır. Geliştiriciler bu alanların ikisini de ayarlayabilir ve Classroom uygulamasının davranışını taklit etmelidir. Örneğin, assignedGrade, draftGrade olmadan ayarlanamaz. Her iki alan da ondalık sayıyla gösterilir. Ayarlanmazsa, öğretmenin ilgili notu henüz belirlemediğini gösterir. Notları okuma, ayarlama ve döndürmeyle ilgili kod örnekleri için Not oluşturma ve yönetme başlıklı makaleyi inceleyin.

Öğrenciler aynı CourseWork ödevine birden fazla gönderim yapabilir. Gönderim durumu ve not geçmişi StudentSubmission.submissionHistory'da izlenir.

Geç, mazeretli ve eksik kurs çalışmaları

CourseWork öğe atandığında, öğrenci ilgili ödevle etkileşimde bulunmamış olsa bile her öğrenci için StudentSubmissions yer tutucusu oluşturulur. Öğretmenler, CourseWork üzerinde bir dueDate ayarlayabilir ve öğrenci ödevi tarihten önce teslim etmezse ilişkili StudentSubmissions bir late alanıyla (true olarak ayarlanır) işaretlenir. Öğretmenler, Classroom uygulamasındaki bir ayarla geç gönderilen ödevleri devre dışı da bırakabilir.

Ayrıca, dueDate tarihinden önce gönderilmeyen StudentSubmissions'ler Classroom not defterinde eksik olarak işaretlenir. Öğretmenler, Classroom uygulamasında gönderimleri manuel olarak eksik olarak da işaretleyebilir. Teslim edilmemiş ödevlere otomatik olarak bir draftGrade verilir. Bu puan, öğretmen tarafından özelleştirilebilir ancak varsayılan olarak 0'dır.

Eksik gönderimler öğretmen tarafından tamamlandı veya maddi hariç olarak işaretlenebilir. Tamamlandı olarak işaretlenen StudentSubmissions'lerin varsayılan draftGrade alanı, öğretmen yeni bir alan ayarlayana kadar kaldırılır. Muaf tutuldu olarak işaretlenen StudentSubmissions, notlandırma dönemleri dahil olmak üzere genel puan hesaplamalarından çıkarılır.

Gönderimlerin öğretmenler tarafından nasıl ele alınabileceği hakkında daha fazla bilgi edinmek için ödev notu verme ve ödevi iade etme yardım makalesine göz atın.

Genel not ve notlandırma sistemleri

Classroom, öğrencilerin kurstaki genel notlarını hesaplamak için birden fazla notlandırma sistemini destekler. Genel notlar doğrudan toplam puandan, kategoriye göre ağırlıklı olarak veya hiç hesaplanmadan hesaplanabilir.

Farklı notlandırma sistemleri hakkında örneklerle bilgi edinmek için notlandırmayı ayarlama makalesine bakın.

Bazı önemli noktalar:

• Course kaynağında, ders not ayarlarıyla ilgili ayrıntıları içeren bir gradebookSettings nesnesi bulunur.
  • calculationType, ders için hesaplama yöntemini belirtir.
  • displaySettings, Classroom uygulamasında genel notları kimin görebileceğini belirtir. Mümkün olduğunda kendi uygulamanızda bu değere uymanız önerilir. Örneğin, öğrenciler Classroom'da genel notlarını göremiyorsa bu notu uygulamanızda göstermeyin.
  • gradeCategories, kurs için yapılandırılmış notlandırma kategorilerinin listesini (görünen adları, ağırlık yüzdeleri ve ilgili ödevler için varsayılan puanlar dahil) içerir.
• Bir kursta ağırlıklı notlandırma kullanılıyorsa bir kategorinin bulunmadığı senaryolarda ağırlıkları normalleştirmeniz gerekebilir. Örneğin, kategori ağırlıkları ev ödevleri için% 20, alıştırma soruları için% 10 ve testler için% 70 ise ancak alıştırma soruları yoksa Classroom, genel notları hesaplarken ağırlıkları ev ödevleri için yaklaşık% 22 ve testler için yaklaşık %78 olacak şekilde ayarlar. Classroom'daki genel notları uygulamanızda yansıtmak istiyorsanız aynısını yapmanız gerekir.

Notlandırma dönemleri

Öğretmenler, dersteki CourseWork ödevleri notlandırma dönemleri adı verilen farklı tarih aralıklarında gruplandırabilir. Notlandırma dönemleri, not defteri görünümündeki kurs çalışmalarını filtrelemek ve genel not hesaplamaları için farklı gruplar oluşturmak amacıyla kullanılabilir.

Örneğin, bir öğretmen "ilkbahar" ve "sonbahar" sömestr notlandırma dönemleri oluşturabilir. Bahar dönemine ait genel not puanı yalnızca bahar tarih aralığında StudentSubmissions ödenecektir.

Ders için ayarlanan notlandırma sistemi, notlandırma dönemlerini de kapsar. Bu nedenle, yukarıda belirtilen bahar ve sonbahar notlandırma dönemleri, ağırlıklı notlandırma kategorilerinin kullanıldığı bir kursta ayarlanmışsa öğrenciler için üç genel not grubu olur:

• Kurstaki tüm ödevler için genel not.
• Bahar dönemi tarih aralığındaki tüm ödevler için genel not.
• Güz tarih aralığındaki tüm ödevler için genel not.

Bu üç yöntemin de genel notu ağırlıklı kategorilerle hesaplaması gerekir.

Özellikle ilgili genel bilgi edinmek için derecelendirme dönemleri duyurusuna bakın.

Notlandırma dönemleri, ödevin ait olduğu notlandırma dönemini tanımlayan bir gradingPeriodId ile CourseWork uzatılır.

Notlandırma dönemlerini API ile nasıl okuyacağınızı ve yöneteceğinizi öğrenmek için notlandırma dönemleri API kılavuzuna bakın.

Puan anahtarları

Öğretmenler, Rubrics puan anahtarları oluşturup CourseWork ödevleriyle ilişkilendirebilir ve ilgili StudentSubmissions'ye not verirken bu puan anahtarlarını rehber olarak kullanabilir.

Öğretmenlerin Classroom'da puan anahtarlarını nasıl kullanabileceğini öğrenmek için puan anahtarları makalesine göz atın.

Ölçütler, StudentSubmissions kaynağını ek alanlarla genişletir:

• rubricId, gönderimin CourseWork değerine karşılık gelen notlandırmayı tanımlar.
• draftRubricGrades, öğretmenin gönderimi öğrenciye geri vermeden önce oluşturduğu ölçütleri ve yer tutucu puanları temsil eder.
• assignedRubricGrades, öğretmen gönderimi geri verdikten sonra öğrencinin aldığı ölçütleri ve puanları temsil eder.

API ile notlandırma ölçeklerini yönetme ve ilgili notları okuma hakkında bilgi edinmek için notlandırma ölçekleri API kılavuzuna bakın.

Notlandırma ölçekleri

Classroom, özelleştirilebilir notlandırma ölçeklerini destekler. Örneğin, öğretmenler bu ölçekler sayesinde sayısal notları harf notlarına dönüştürebilir. Bu ayarlar ve ilgili veriler API'de bulunmamaktadır.