Method: courses.courseWork.rubrics.patch

Puan anahtarını günceller.

Hangi alanların güncellenebileceğiyle ilgili ayrıntılar için google.classroom.v1.Rubric bölümüne bakın. Notlandırma işlemi başladıktan sonra notlandırma ölçeği güncelleme özellikleri sınırlı olur.

İstekte bulunan kullanıcı ve kurs sahibinin notlandırma sistemi oluşturma yetkisine sahip olması gerekir. Ayrıntılar için lisanslama koşullarına göz atın.

Bu istek, üst düzey kurs çalışma öğesini oluşturmak için kullanılan OAuth istemci kimliğinin Google Cloud Console'u tarafından gönderilmelidir.

Bu yöntem aşağıdaki hata kodlarını döndürür:

  • PERMISSION_DENIED istek gönderen geliştirici projesi ilgili kurs çalışmasını oluşturmadıysa, kullanıcının notlandırmada istenen değişikliği yapmasına izin verilmiyorsa veya erişim hataları nedeniyle. Bu hata kodu, notlandırma puanlandırma ölçeğinde zaten başlatılmışsa da döndürülür.
  • INVALID_ARGUMENT isteğinde yanlış biçimlendirme varsa ve aşağıdaki istek hatası için:
    • RubricCriteriaInvalidFormat
  • İstenen kurs, kurs çalışması veya notlandırma mevcut değilse ya da kullanıcı ilgili kurs çalışmasına erişemiyorsa NOT_FOUND.
  • INTERNAL notlandırma puanlandırma ölçütünde zaten başladıysa.

HTTP isteği

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
courseId

string

Zorunlu. Dersin tanımlayıcısıdır.
courseWorkId

string

Zorunlu. Ders çalışmasının tanımlayıcısı.
id

string

İsteğe bağlı. Notlandırmanın tanımlayıcısıdır.

Sorgu parametreleri

Parametreler
updateMask

string (FieldMask format)

İsteğe bağlı. Puan çizelgesinde hangi alanların güncelleneceğini tanımlayan maske. Güncelleme yapmak için bu alanın doldurulması gerekir. Geçersiz alanlar belirtilirse güncelleme başarısız olur. Notlandırma ölçütlerini tanımlamak için birden fazla seçenek vardır: sourceSpreadsheetId ve criteria listesi. Bir notlandırmayı tanımlamak için aynı anda bunlardan yalnızca biri kullanılabilir.

criteria listesi, güncelleme isteğinde belirtilen not ölçütleriyle tamamen değiştirilir. Örneğin, istekte eksik bir ölçüt veya düzey varsa silinir. Yeni ölçütler ve düzeyler eklenir ve bir kimlik atanır. Mevcut ölçütler ve düzeyler, kimlik isteğinde belirtilmişse daha önce atanan kimliği korur.

Öğretmenler aşağıdaki alanları belirtebilir:

  • criteria
  • sourceSpreadsheetId

Bu, alanların tam nitelikli adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".
previewVersion

enum (PreviewVersion)

İsteğe bağlı. API'nin önizleme sürümü. Önizleme programında geliştiricilere sunulan yeni API özelliklerine erişmek için bu ayar yapılmalıdır.

İstek içeriği

İstek metni, Rubric öğesinin bir örneğini içerir.

Yanıt gövdesi

Başarılıysa yanıt metni, Rubric öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/classroom.coursework.students

Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.