Puan anahtarı yapısı ve bilinen sınırlamalar

Classroom derecelendirme ölçeklerini bilmiyorsanız derecelendirme ölçeğinin genel yapısı ve Classroom kullanıcı arayüzünde derecelendirme ölçeğiyle notlandırma hakkında bilgi edinmek için bu Yardım Merkezi makalelerini inceleyin.

Puan anahtarı yapısı

API'yi kullanarak derecelendirme ölçekleriyle etkileşim kurarken vurgulanması gereken bazı önemli kavramlar vardır:

  • Bir CourseWork ile ilişkilendirilmiş (en fazla) tek bir puanlama anahtarı vardır ve bu puanlama anahtarı söz konusu CourseWork'ye özgüdür (CourseWork kaynakları arasında paylaşılamaz).
  • Puan anahtarı, seviyelerden oluşan ölçütlerden oluşur. Değerlendirme ölçeğinde her zaman en az bir ölçüt, ölçütte ise her zaman en az bir seviye olmalıdır.
  • Seviyeler puanlı (puan içeren) veya puansız (puan içermeyen) olabilir. Düzeyler, derecelendirme ölçeğinde tamamen puanlanmış veya tamamen puanlanmamış olmalıdır.
    • Seviyeler puanlandırılıyorsa bir ölçütteki tüm seviyelerde benzersiz bir puan değeri ayarlanmış olmalıdır. Puanlar tam sayı (ör. 10) veya kayan nokta değeri (ör. 9,99) olabilir. Bu değer 0 olabilir. Boş değerler kabul edilmez. Ayrıca, puan anahtarında 0 puanlık tek bir seviyeye sahip tek bir ölçüt olamaz.
    • Seviyeler puanlanmamışsa puan alanı atlanmalıdır. Boş değerler kabul edilmez.
  • Ölçütlerin ve seviyelerin sırası anlamlıdır ve Classroom kullanıcı arayüzünde gösterildikleri sırayı yansıtır.
    • Özellikle puanlı seviyeler her zaman artan veya azalan düzende puanlara göre sıralanmalıdır.
  • Puan anahtarı başına en çok 50 ölçüt ve ölçüt başına en çok 10 performans düzeyi olabilir.

StudentSubmission nesneleri, değerlendirme ölçekleriyle ilgili alanları destekler:

  • Mevcut draftGrade ve assignedGrade özelliklerine ek olarak, puan anahtarıyla notlandırılan bir öğrenci gönderiminde draftRubricGrades ve assignedRubricGrades özellikleri bulunur. Bunlar, öğrencinin notlandırma sırasında puan anahtarından aldığı puan anahtarı notlarını (seçilen düzeyler ve puan değerleri) sırasıyla taslak ve atanmış durumlarında gösterir.
  • Bu özellikler şu anda salt okunur durumdadır. Bu nedenle, API, gönderilere not vermek için kullanılamaz ancak Classroom kullanıcı arayüzünde not verilen gönderileri okuyabilirsiniz.

Puan anahtarı davranışları

API, tutarlılık için mümkün olduğunda Classroom kullanıcı arayüzünü yansıtmayı amaçlar. Ancak bu durum, geliştiriciler için sezgisel olmayan davranışlara yol açabilir ve bu nedenle belirtilmesi gerekir:

  • Derecelendirme ölçekleri, öğretmenleri kısıtlamadan not verme sürecine rehberlik etmeyi amaçlar. Bu nedenle, öğretmenler bir gönderimi puan anahtarıyla notlandırırken şunları yapabilir:
    • Not verirken puan anahtarını tamamen göz ardı etme.
    • Ölçütün seviyelerinde bulunan puanlardan bağımsız olarak bir ölçütün puanlarını geçersiz kılabilirsiniz.
    • Yalnızca ölçütlerin bir alt kümesi için düzey seçebilirsiniz.
    • İlgili seviyeyi seçmeden bir ölçüt için puan atama
    • Puan anahtarından alınacak puanlardan bağımsız olarak ödevin toplam puanını geçersiz kılabilirsiniz.

Ayrıca API, Classroom kullanıcı arayüzünde bulunmayan davranışları desteklemez. Örneğin, API, ödevlerde derecelendirme anahtarı kullanımını zorunlu kılmaya veya öğretmenlerin derecelendirme anahtarlarını ve gönderimleri düzenleme olanağını geçersiz kılmaya izin vermez.

Notlandırma sırasındaki sınırlamalar

Benzer şekilde, bir öğretmen değerlendirme ölçeğiyle not vermeye başladıktan sonra değerlendirme ölçeğini düzenleme konusunda bazı ek sınırlamalar vardır. Not verme işlemi başladıktan sonra yalnızca aşağıdaki düzenlemeler yapılabilir:

  • Ölçüt ve seviye başlıkları ile açıklamalarında metin düzenlemelerine izin verilir.
  • Seviye sıralaması, ölçütler içinde değişebilir.

Ek kapsamlar

Rubrikler, öğretmenlerin yeniden kullanabilmesi için Google E-Tablolar'a manuel olarak aktarılabilir.

Bu e-tablolardan bir puan anahtarı oluşturur veya güncellerseniz (kılavuzdaki örneğe bakın) uygulamanızın https://www.googleapis.com/auth/spreadsheets.readonly veya https://www.googleapis.com/auth/spreadsheets kapsamını istemesi gerekir. spreadsheets kapsamlarının hassas olarak kabul edildiğini ve uygulamanızın doğrulanmasını gerektirebileceğini unutmayın.

Üçüncü taraf çalışma materyali

Değerlendirme ölçekleri yalnızca üst CourseWork öğesini oluşturan Google Cloud projesi tarafından oluşturulabilir. Bu, Classroom API'deki daha geniş bir tasarım kalıbıdır ve farklı uygulamaların kendilerine ait olmayan kaynakları etkilemesini önler.

Bu durum, Classroom uygulamasında kullanıcılar tarafından oluşturulan kaynaklar için de geçerlidir. Örneğin, aynı öğretmen uygulamaya sahip olsa bile bir uygulamanın, Classroom kullanıcı arayüzünde öğretmen tarafından oluşturulan bir çalışma materyalinin puan anahtarlarını yönetmesi mümkün değildir. Bu durum kullanım alanınızı önemli ölçüde sınırlıyorsa genel sorun izleyicide geri bildirim paylaşın.

Lisans koşulları

Bir kullanıcı, yalnızca aşağıdaki koşullar karşılandığında Classroom API ile derecelendirme ölçekleri oluşturabilir, güncelleyebilir ve silebilir:

API özelliklerinin kullanıcılara nasıl sunulduğu hakkında daha fazla bilgi edinmek için kullanıcı uygunluğu bölümünü, geliştirme için demo hesabı isteğinde bulunmak ve bu hesabı kullanmak üzere Classroom API ön koşulları bölümünü inceleyin.

Önceki
Notlandırma Dönemleri