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

Classroom Puan Anahtarları hakkında bilgi sahibi değilseniz bilgi edinmek için bu Yardım Merkezi makalelerini inceleyebilirsiniz Puan anahtarının genel yapısı ve puan anahtarıyla not vermenin Classroom kullanıcı arayüzünde.

Puan anahtarları yapısı

Puan anahtarlarıyla etkileşimde bulunmak için API:

  • Bir CourseWork ve bu puan anahtarı o CourseWork için özeldir ( CourseWork kaynaklar).
  • Puan anahtarı, seviyelerden oluşan ölçütlerden oluşur. Puan anahtarı, her zaman en az bir ölçüt içermelidir ve bir ölçüt her zaman en az bir ölçüt içermelidir tek seviye.
  • Seviyeler puanlanabilir (puan içerir) veya eksik (puan olmaz) olabilir. Seviyeler şöyle olmalıdır: puan anahtarında tamamen puanlanmış veya hiç puanlanmamıştır.
    • Seviyeler puanlanırsa ölçütteki tüm düzeyler benzersiz olmalıdır puan değeri ayarlandı. Noktalar tamsayı (ör. 10) veya kayan nokta olabilir 9,99 gibi) olması gerekir. Bu sayı 0 değerini içerebilir. Boş değerler kabul edilmez. Ayrıca, bir puan anahtarında tek bir düzeyde tek bir ölçüt bulunamaz yani 0 puan.
    • Seviyeler puanlanmamışsa, puan alanı atlanmalıdır; boş değerleri kabul edilmez.
  • Ölçütlerin ve seviyelerin sırası anlamlıdır ve bunların her birinin Classroom kullanıcı arayüzünde gösterilir.
    • Özellikle puanlı seviyeler, bir eylemde bulunmaktır.
  • Puan anahtarı başına en fazla 50 ölçüt ve en fazla 10 performans düzeyi olabilir belirlenebilir.

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

  • Mevcut draftGrade ve assignedGrade özelliklerine ek olarak Puan anahtarı ile not verilen öğrencinin ödevi draftRubricGrades ve assignedRubricGrades mülk. Bunlar, değerlendirme ölçeği notlarını (seviye ve puan değerlerini içerir) puan anahtarı, sırasıyla taslak ve atanmış durumlarda.
  • Şimdilik bu özellikler salt okunurdur. Bu, API'nin gönderimlere not vermek için kullanılır ancak Classroom kullanıcı arayüzü.
  • İlişkili bir puan anahtarı olan öğrenci gönderimleri bir rubricId alanı içerir. Bu alan CourseWork ile ilişkili en son puan anahtarını gösterir. Ayrıca, öğretmenler bir puan anahtarını silip yeniden oluşturursa bu değer değişebilir.

Puan anahtarı davranışları

API, tutarlılık sağlamak için mümkün olduğunda Classroom kullanıcı arayüzünü yansıtmayı amaçlar. bu da geliştiriciler için sezgisel olmayan ve değerli bir davranış bahsediliyor:

  • Puan anahtarları, öğretmenleri kısıtlamadan notlandırmaya rehberlik etmek için tasarlanmıştır. Kullanıcı öğretmenler, ödevlere not verirken aşağıdakileri yapabilirler: değerlendirme ölçeği:
    • Not verirken puan anahtarını tamamen yoksayın.
    • Puanlar ne olursa olsun ölçüt için puanları geçersiz kıl ölçüt düzeylerinde kullanılabilir.
    • Ölçütlerin yalnızca bir alt kümesi için düzey seçin.
    • İlgili seviyeyi seçmeden bir ölçüt için puan atayın.
    • Ödevin toplam puanı, ödevin verdiği puanlara bakılmaksızın rubrik yani puan anahtarından gelir.

Ayrıca, API yeni ürün özellikleri sunmuyor. Başka API, Classroom kullanıcı arayüzünde henüz sahip olmadığı davranışı desteklemez. Örneğin, API, ödevlerde veya ödevlerde puan anahtarı kullanımını zorunlu kılmayı ya da bir öğretmenin, puan anahtarlarını ve gönderimleri yapabildiği şekilde düzenlemesini .

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

Benzer şekilde, cevap anahtarlarının düzenlenmesinde bazı ek sınırlamalar da vardır. öğretmeni bu araçla not vermeye başladı. Şu tarihten sonra yalnızca aşağıdaki düzenlemeler yapılabilir: notlandırma başlangıcı:

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

Ek kapsamlar

Puan anahtarları, Google E-Tablolar'a manuel olarak dışa aktarılabilir öğretmenlerdir.

Bu e-tablolardan bir puan anahtarı oluşturur veya bir puan anahtarını güncellerseniz (bkz. kılavuz) gönderilirse, uygulamanızın https://www.googleapis.com/auth/spreadsheets.readonly veya https://www.googleapis.com/auth/spreadsheets kapsamı. Lütfen spreadsheets kapsamları hassas kabul edilir ve uygulamanızı gerektirebilir doğrulanması gerekir.