REST Resource: courses.courseWork.rubrics

Kaynak: Puan anahtarı

Sınıf çalışmasının puan anahtarı. Puan anahtarı, öğrenci çalışmalarını değerlendirmek ve geri bildirim vermek için kullanılan bir puanlama kılavuzudur.

Daha fazla bilgi için Puan anahtarı yapısı ve bilinen sınırlamalar başlıklı makaleyi inceleyin.

JSON gösterimi
{
  "courseId": string,
  "courseWorkId": string,
  "id": string,
  "creationTime": string,
  "updateTime": string,
  "criteria": [
    {
      object (Criterion)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  "sourceSpreadsheetId": string
}
Alanlar
courseId

string

Dersin tanımlayıcısı.

Salt okunur.

courseWorkId

string

Bu notun karşılık geldiği sınıf çalışmasının tanımlayıcısı.

Salt okunur.

id

string

Puan anahtarı için Classroom tarafından atanan tanımlayıcı. Bu, ilgili sınıf çalışmasının puan anahtarları arasında benzersizdir.

Salt okunur.

creationTime

string (Timestamp format)

Yalnızca çıkış. Bu puan anahtarının oluşturulduğu zaman damgası.

Salt okunur.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Yalnızca çıkış. Bu puan anahtarında yapılan en son değişikliğin zaman damgası.

Salt okunur.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

criteria[]

object (Criterion)

Ölçüt listesi. Her ölçüt, performansın değerlendirildiği bir boyuttur.

previewVersion

enum (PreviewVersion)

Yalnızca çıkış. Bu kaynağı almak için kullanılan API'nin önizleme sürümü.

Mevcut bir kaynaktan puan anahtarı oluşturma seçenekleri. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
sourceSpreadsheetId

string

Yalnızca giriş. Değiştirilemez. E-tablonun Google E-Tablolar kimliği. Bu e-tablo, biçimlendirilmiş puan anahtarı ayarları içermelidir. Ödev için puan anahtarı oluşturma veya mevcut puan anahtarını yeniden kullanma başlıklı makaleyi inceleyin. Bu alanın kullanımı için https://www.googleapis.com/auth/spreadsheets.readonly veya https://www.googleapis.com/auth/spreadsheets kapsamı gerekir.

Birbirini hariç tutan alanların sonu.

Ölçüt

Puan anahtarı ölçütü. Her ölçüt, performansın değerlendirildiği bir boyuttur.

JSON gösterimi
{
  "id": string,
  "title": string,
  "description": string,
  "levels": [
    {
      object (Level)
    }
  ],
  "learningGoal": {
    object (LearningGoal)
  }
}
Alanlar
id

string

Ölçüt kimliği.

Oluşturma sırasında bir kimlik atanır.

title

string

Ölçütün başlığı.

description

string

Ölçütün açıklaması.

levels[]

object (Level)

Bu ölçüt kapsamındaki seviyelerin listesi.

learningGoal

object (LearningGoal)

İsteğe bağlıdır.

Bu ölçütle ilişkili öğrenme hedefi. Puan anahtarı ölçütlerine eklenen öğrenme hedeflerinin, puan anahtarının bağlı olduğu ödeve daha önce eklenmiş olması gerektiğini unutmayın. Bu alan yalnızca uygun previewVersion ayarlandığında doldurulur.

Seviye

Ölçütün bir düzeyi.

JSON gösterimi
{
  "id": string,
  "title": string,
  "description": string,
  "points": number
}
Alanlar
id

string

Seviye kimliği.

Oluşturma sırasında bir kimlik atanır.

title

string

Seviyenin başlığı.

Seviye için puan ayarlanmamışsa başlık ayarlanmalıdır.

description

string

Seviyenin açıklaması.

points

number

Bu seviyeyle ilişkili isteğe bağlı puanlar. Bu seçenek ayarlanırsa puanlama anahtarındaki tüm seviyeler için puan belirtilmeli ve tek bir ölçüt içindeki tüm seviyelerde değer farklı olmalıdır. 0, "puan yok"tan farklıdır.

Yöntemler

create

Puan anahtarı oluşturur.

delete

Puan anahtarını siler.

get

Puan anahtarı döndürür.

list

İstekte bulunan kullanıcının görüntülemesine izin verilen puan anahtarlarının listesini döndürür.

patch

Puan anahtarını günceller.