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

Classroom notlandırma ölçekleriyle ilgili bilginiz yoksa notlandırma ölçeğinin genel yapısı ve Classroom kullanıcı arayüzünde notlandırma ölçeğiyle notlandırma hakkında bilgi edinmek için bu Yardım Merkezi makalelerine göz atın.

Puan anahtarı yapısı

Ölçütlerle etkileşim kurmak için API'yi kullanırken vurgulamaya değer bazı önemli kavramlar vardır:

  • Bir CourseWork ile ilişkili (en fazla) tek bir rubrik vardır ve bu rubrik söz konusu CourseWork'a özgüdür (CourseWork kaynakları arasında paylaşılamaz).
  • Ölçütler, seviyelerden oluşan ölçütlerden oluşur. Bir notlandırmada her zaman en az bir ölçüt, ölçütte ise her zaman en az bir seviye olmalıdır.
  • Seviyeler puanlanabilir (puanları vardır) veya puanlanamaz (puanları yoktur). Seviyeler, notlandırma ölçeğinde tamamen puanlanmalı veya puanlanmamalıdır.
    • Seviyeler puanlanıyorsa bir ölçütteki tüm seviyelerin benzersiz bir puan değeri grubu olmalıdır. Puanlar tam sayı (ör. 10) veya kayan noktalı değer (ör. 9,99) olabilir. 0 da bu değerler arasında yer alabilir. Boş değerler kabul edilmez. Ayrıca, notlandırma ölçeğinde 0 puan olan 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 düzeylerin sırası anlamlıdır ve Classroom kullanıcı arayüzünde gösterildikleri sırayı yansıtır.
    • Özellikle puanlı seviyeler her zaman puana göre artan veya azalan düzende sıralanır.
  • Puan anahtarı başına en fazla 50 ölçüt ve ölçüt başına en fazla 10 performans düzeyi olabilir.

StudentSubmission nesneleri, notlarla ilgili alanları destekler:

  • Puan çizelgesi ile notlandırılan öğrenci gönderimlerinde, mevcut draftGrade ve assignedGrade özelliklerine ek olarak draftRubricGrades ve assignedRubricGrades özellikleri de bulunur. Bunlar, öğrencinin notlandırma sırasında değerlendirme ölçütünden aldığı notları (seçilen seviyeler ve puan değerleri) sırasıyla taslak ve atanmış durumlarında gösterir.
  • Bu özellikler şu anda salt okunur durumdadır. Yani 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ı hedefler ancak bu, geliştiriciler için sezgisel olmayan davranışlara neden olabilir ve bahsetmeye değerdir:

  • Ölçütler, öğretmenleri kısıtlamadan not verme konusunda rehberlik etmeyi amaçlar. Sonuç olarak, öğretmenler bir gönderimi notlandırmak için puanlandırma ölçütlerini kullanarak şunları yapabilir:
    • Not verirken puan anahtarını tamamen yoksayma.
    • Ölçütün seviyelerinde mevcut puanlardan bağımsız olarak bir ölçüt için puanları geçersiz kılabilirsiniz.
    • Yalnızca ölçütlerin bir alt kümesi için düzey seçin.
    • İlgili bir seviye seçmeden ölçütlere puan atayın.
    • 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ı zorunlu kılma veya öğretmenlerin puan anahtarlarını ve gönderimleri düzenleme özelliğini geçersiz kılma olanağı sunmaz.

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çeklerini 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ı için metin düzenlemelerine izin verilir.
  • Ölçütler dahilinde seviye sıralaması değişebilir.

Ek kapsamlar

Puan anahtarları, öğretmenler tarafından yeniden kullanılmak üzere Google E-Tablolar'a manuel olarak dışa aktarılabilir.

Bu e-tablolardan bir notlandırma oluşturur veya güncellerseniz (kılavuzda bir ö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 kabul edildiğini ve uygulamanızın doğrulanmasını gerektirebileceğini unutmayın.

Üçüncü taraf ders çalışmaları

Ölçütler yalnızca üst CourseWork öğeyi 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 kendi kaynakları dışındaki kaynakları etkilemesini önler.

Bu durum, Classroom uygulamasında kullanıcılar tarafından oluşturulan kaynaklar için de geçerlidir. Örneğin, bir uygulamanın, uygulamanın sahibi olan öğretmenin Classroom kullanıcı arayüzünde oluşturduğu bir kurs çalışmasının notlandırma sistemini yönetmesi mümkün değildir. Bu durum kullanım alanınızı önemli ölçüde kısıtlarsa herkese açık sorun izleyicide geri bildirim paylaşın.

Lisans koşulları

Kullanıcılar Classroom API ile notlandırma oluşturmak, güncellemek ve silmek için aşağıdaki koşulları karşılamalıdır:

API özelliklerinin kullanıcılara nasıl sunulduğu ve Classroom API'yi tanımak ve geliştirme için demo hesap istemek üzere ön koşullar hakkında daha fazla bilgi edinmek için kullanıcı uygunluğu bölümüne bakın.

Önceki
Notlandırma Dönemleri