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 derecelendirme ölçekleriyle etkileşim kurmak için kullanırken 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).
  • Puanlama 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ı (puanlı) veya puansız (puan yok) 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 seviyelerin benzersiz bir puan değeri kümesi olmalıdır. Puanlar tam sayı (ör. 10) veya kayan nokta değeri (ör. 9,99) olabilir. 0 da dahil olabilir. Boş değerler kabul edilmez. Ayrıca, puan anahtarlarında 0 puanlık tek bir seviyeye sahip tek bir ölçüt olamaz.
    • Seviyeler puanlanmıyorsa 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 puanlanan 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, derecelendirme ölçeğiyle not verilen bir öğrenci gönderiminde draftRubricGrades ve assignedRubricGrades özellikleri bulunur. Bunlar, öğrencinin değerlendirme sırasında değerlendirme ölçeğinden aldığı değerlendirme ölçeği notlarını (seçilen seviyeler ve puan değerleri) sırasıyla taslak ve atanmış durumlarında gösterir.
  • Bu özellikler şu anda salt okunurdur. 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, 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 sayede, öğretmenler bir gönderiyi derecelendirme ölçeğiyle 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 ölçeği kullanımının zorunlu kılınmasına veya öğretmenlerin derecelendirme ölçeklerini 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üzenlemeyle ilgili bazı ek sınırlamalar vardır. Notlandırma 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.
  • Düzey 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 elektronik tablolardan bir derecelendirme ölçeği 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 kursları

Değerlendirme ölçütleri 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 ödevin değerlendirme ölçeklerini 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