Bu belgede, Classroom API ile ilgili notlandırma kavramları tanıtılmaktadır.
Google Classroom uygulamasında öğretmenlerin not verme süreçleri hakkında bilgi edinmek için Ödevlere not verme ve ödevleri izleme başlıklı makaleyi inceleyin.
CourseWork ve Öğrenci Gönderimleri
Google Classroom'da öğrenciler, Course
'teki CourseWork
ödevleri için StudentSubmissions
gönderir. CourseWork
notlandırılabilir veya notlandırılmayabilir. 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, notlandırılmış ödevleri öğrenciye geri vermeden önce StudentSubmission
üzerinde bir draftGrade
notu belirler. 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ılarla temsil edilir ve ayarlanmazsa öğretmenin henüz ilgili notu ayarlamadığı anlamına gelir.
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
öğeleri atandığında, ilgili ödevle etkileşime geçmemiş olsa bile her öğrenci için StudentSubmissions
yer tutucu 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 muaf olarak işaretlenebilir.
Tamamlandı olarak işaretlenen StudentSubmissions
'lerin varsayılan draftGrade
alanı, öğretmen yeni bir alan ayarlayana kadar kaldırılır. Muaf olarak işaretlenen StudentSubmissions
, notlandırma dönemleri dahil olmak üzere genel puan hesaplamalarından kaldırı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, kurs notu ayarlarıyla ilgili ayrıntıları içeren birgradebookSettings
nesnesi bulunur.calculationType
, kursun 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 uymak en iyi uygulamadır. Örneğin, öğrenciler Classroom'da genel notlarını göremiyorsa uygulamanızda da 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 kategorinin bulunmadığı senaryolarda ağırlıkları normalleştirmeniz gerekebilir. Örneğin, kategori ağırlıkları ev ödevi için% 20, alıştırma soruları için% 10 ve testler için% 70 olsa da aslında alıştırma sorusu yoksa Classroom, genel notları hesaplarken ağırlıkları ev ödevi için yaklaşık% 22'ye, testler için yaklaşık %78'e ayarlar. Classroom'daki genel notları uygulamanızda yansıtmak istiyorsanız aynı işlemi yapmanız gerekir.
Notlandırma dönemleri
Öğretmenler, bir kurstaki CourseWork
ödevi notlandırma dönemleri olarak adlandırılan 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. İlkbahar dönemi için genel not puanı yalnızca ilkbahar tarih aralığında teslim edilmesi gereken StudentSubmissions
'leri içerir.
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.
- Sonbahar tarih aralığındaki tüm ödevler için genel not.
Bu üç yöntemin de genel notu ağırlıklı kategorilerle hesaplaması gerekir.
Özelliğe genel bir bakış için notlandırma dönemleri duyurusuna bakın.
Notlandırma dönemleri, ödevin dahil olduğu notlandırma dönemini tanımlayan bir gradingPeriodId
ile CourseWork
'ü genişletir.
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 bu puan anahtarlarını ilgili StudentSubmissions
'lere not verirken rehber olarak kullanabilir.
Öğretmenlerin Classroom'da notlandırma ölçeklerini nasıl kullanabileceğini öğrenmek için notlandırma ölçekleri makalesine göz atın.
Ölçütler, StudentSubmissions
kaynağını ek alanlarla genişletir:
rubricId
, gönderiminCourseWork
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 kullanılamaz.