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

Classroom Rubrikleri'ni bilmiyorsanız rubriklerin genel yapısı ve Classroom kullanıcı arayüzünde rubrik notlandırmasının nasıl yapıldığı hakkında bilgi edinmek için bu Yardım Merkezi makalelerini inceleyin.

Puan anahtarı yapısı

Puanlama ölçekleriyle etkileşim kurmak için API'yi 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ı (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 ayarlanmalı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 anahtarlarında 0 puanlık tek bir seviyeye sahip tek bir ölçüt bulunamaz.
    • 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 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, 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 nedenle, öğ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 puan anahtarı kullanımının zorunlu kılınmasına veya öğretmenlerin puan anahtarlarını ve gönderimleri düzenleme yetkisini geçersiz kılmaya olanak tanımaz.

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 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 kursları

Derecelendirme ö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 ö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