Notlar

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 bir gradebookSettings 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ö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 kullanılamaz.

Önceki
API kaynakları
Sonraki
Kullanıcı türleri