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

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

Puan anahtarları 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 puan anahtarı vardır ve bu puan anahtarı, söz konusu CourseWork için benzersizdir (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. Bu değer 0 olabilir. Boş değerler kabul edilmez. Ayrıca, notlandırma ölçeğinde 0 puan olan tek bir düzeye 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ıralanmalıdır.
• Puan anahtarı başına en fazla 50 ölçüt ve ölçüt başına en fazla 10 performans düzeyi olabilir.

İlgili öğrenci gönderimi alanları

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

• Puan anahtarı ile not verilen bir öğrencinin, mevcut draftGrade ve assignedGrade özelliklerine ek olarak draftRubricGrades ve assignedRubricGrades özellikleri de vardır. 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. Bu durumda, API, gönderimlere not vermek için kullanılamaz, ancak not verilen gönderimleri Classroom kullanıcı arayüzünde okuyabilirsiniz.
• İlişkili puan anahtarı olan öğrenci gönderimleri bir rubricId alanı içerir. Bu alan, CourseWork ile ilişkili en son notlandırmayı temsil eder. Öğretmenler bir notlandırmayı 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ı hedefler ancak bu durum, geliştiricilerin pratik yapmayabileceği ve bundan 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 ödeve puan anahtarıyla not verirken aşağıdakileri yapabilir:
  • Not verirken puan anahtarını tamamen yoksayabilirsiniz.
  • Ö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 yeni ürün özellikleri sunmuyor. Başka bir deyişle, API, Classroom kullanıcı arayüzünde henüz sahip olmadığı davranışları desteklemez. Örneğin, API'nin şu anda kullanılabildiği gibi ödevlerde puan anahtarı kullanımını zorunlu kılma veya öğretmenin puan anahtarlarını ve gönderimleri düzenleme özelliğini geçersiz kılma gibi işlevleri yoktur.

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

Benzer şekilde, öğretmen not vermeye başladığında puan anahtarlarının düzenlenmesiyle ilgili bazı ek sınırlamalar da uygulanır. Sınıflandırma başlangıcından 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ı, öğretmenlerin yeniden kullanması için 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ı gerekebileceğini unutmayın.