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

Classroom Puan Anahtarları'na aşina değilseniz puan anahtarının genel yapısı hakkında bilgi edinmek ve puan anahtarı not verme işleminin Classroom kullanıcı arayüzünde nasıl yapıldığını öğrenmek için bu Yardım Merkezi makalelerine bakın.

Puan anahtarları yapısı

Puan anahtarlarıyla etkileşimde bulunmak için API'yi kullanırken vurgulamaya değer bazı önemli kavramlar vardır:

  • CourseWork ile ilişkilendirilmiş (en fazla) tek bir puan anahtarı vardır ve bu puan anahtarı söz konusu CourseWork'a özgüdür (CourseWork kaynak arasında paylaşılamaz).
  • Puan anahtarı, seviyelerden oluşan ölçütlerden oluşur. Puan anahtarı her zaman en az bir ölçüt, ölçütlerin ise en az bir düzeyi olmalıdır.
  • Seviyeler puanlanabilir (puan içerir) veya puanlanmamış (puansız) olabilir. Seviyeler, bir puan anahtarında tamamen puanlanmış veya hiç puanlanmamış olmalıdır.
    • Düzeyler puanlanırsa bir ölçütteki tüm seviyelerin benzersiz bir puan değeri ayarlanmış olmalıdır. Noktalar, tam sayı (10 gibi) veya kayan nokta değerleri (9,99 gibi) olabilir. Bu değer 0'ı içerebilir. Boş değerler kabul edilmez. Ayrıca, bir puan anahtarının 0 puanlık tek bir seviyesi olan tek bir ölçütü olamaz.
    • Seviyeler puanlanmamışsa puan alanı çıkarılmalıdır. Boş değerler kabul edilmez.
  • Ölçüt ve düzeylerin sırası anlamlıdır ve Classroom kullanıcı arayüzünde temsil edilme sırasını yansıtır.
    • Özellikle puanlı düzeyler her zaman artan veya azalan düzende puanlara göre sıralanmalıdır.
  • Puan anahtarı başına en fazla 50 ölçüt ve ölçüt başına en fazla 10 performans düzeyi olabilir.

Öğrenci gönderimi nesneleri de değişiyor:

  • Mevcut draftGrade ve assignedGrade özelliklerine ek olarak, puan anahtarıyla not verilen bir öğrenci gönderimi draftRubricGrades ve assignedRubricGrades özelliklerine sahiptir. Bunlar, öğrencinin not verirken puan anahtarından aldığı puan anahtarı notlarını (seçili seviyeler ve puan değerleri) sırasıyla taslak ve atanan durumlarda temsil eder.
  • Şimdilik bu özellikler salt okunurdur. Bu, API'nin gönderimlere not vermek için kullanılamayacağı anlamına gelir. Ancak, not verilen gönderimleri Classroom kullanıcı arayüzünde okuyabilirsiniz.
  • İlişkili bir puan anahtarı olan öğrenci gönderimleri rubricId alanı içerir. Bu alan, CourseWork ile ilişkilendirilmiş en son puan anahtarını temsil eder. Öğretmenler bir puan anahtarını silip yeniden oluşturursa bu değer değişebilir.

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 ve bahsetmeye değer davranışlara yol açabilir:

  • Puan anahtarları, öğretmenleri kısıtlamadan notlandırmaya rehberlik etmek için tasarlanmıştır. Sonuç olarak, öğretmen bir ödeve puan anahtarıyla not verirken aşağıdakileri yapabilir:
    • Not verirken puan anahtarını tamamen yoksayın.
    • Ölçüt düzeylerinde bulunan puanlardan bağımsız olarak, bir ölçüt için puanları geçersiz kılın.
    • Ölçütlerin yalnızca bir alt kümesi için düzey seçin.
    • Karşılık gelen bir seviye seçmeden bir ölçüt için puan atayın.
    • Ödevin toplam puanlarını (puan anahtarından gelecek puanlardan bağımsız olarak) geçersiz kılabilirsiniz.

Ayrıca API, yeni ürün özelliklerini kullanıma sunmamaktadır. Başka bir deyişle, API, Classroom kullanıcı arayüzünün sahip olmadığı davranışları desteklemez. Örneğin API, ödevlerde puan anahtarının kullanılmasını zorunlu kılmaya veya bir öğretmenin puan anahtarlarını ve gönderimleri şimdi olduğu gibi düzenleme olanağını geçersiz kılmaya olanak tanımaz.

Not verme sırasındaki sınırlamalar

Benzer şekilde, öğretmen puan anahtarını kullanarak not vermeye başladıktan sonra bu puanların düzenlenmesiyle ilgili bazı ek sınırlamalar söz konusudur. Not verme işlemi başladıktan sonra yalnızca aşağıdaki düzenlemeler yapılabilir:

  • Ölçüt ve düzey başlıkları ile açıklamaları için metin düzenlemesine izin verilir.
  • Seviye sıralaması, ölçütler dahilinde değişebilir.

Ek kapsamlar

Puan anahtarları, öğretmenlerin yeniden kullanması için Google E-Tablolar'a manuel olarak dışa aktarılabilir.

Bu e-tablolardan puan anahtarı oluşturur veya güncellerseniz (kılavuzdaki 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ı gerekebileceğini unutmayın.