Method: courses.updateGradingPeriodSettings

Dersin notlandırma dönemi ayarlarını günceller.

İstekte bulunan kullanıcı ve ders sahibi, notlandırma dönemlerini değiştirmeye uygun olmalıdır. Ayrıntılar için lisanslama koşullarını inceleyin.

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

  • PERMISSION_DENIED İstekte bulunan kullanıcının bir dersteki notlandırma dönemi ayarlarını değiştirmesine izin verilmiyorsa veya erişim hataları için:
    • UserIneligibleToUpdateGradingPeriodSettings
  • İstek bozuksa INVALID_ARGUMENT.
  • İstenen ders mevcut değilse NOT_FOUND.

HTTP isteği

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings

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

Yol parametreleri

Parametreler
courseId

string

Zorunlu. Kursun tanımlayıcısı.

Sorgu parametreleri

Parametreler
updateMask

string (FieldMask format)

GradingPeriodSettings'de hangi alanların güncelleneceğini tanımlayan maske.

GradingPeriodSettings gradingPeriods, güncelleme isteğinde belirtilen notlandırma dönemleriyle tamamen değiştirilecek. Örneğin:

  • Listede kimliği olmayan notlandırma dönemleri ekleme olarak kabul edilir ve istekte bulunulduğunda yeni bir kimlik atanır.
  • Şu anda mevcut olan ancak istekte bulunmayan notlandırma dönemleri, silme işlemi olarak kabul edilir.
  • Mevcut bir kimliğin ve değiştirilmiş verilerin bulunduğu notlandırma dönemleri düzenleme olarak kabul edilir. Değiştirilmemiş veriler olduğu gibi kalır.
  • Bilinmeyen bir kimlikle eklenen notlandırma dönemleri hatayla sonuçlanır.

Aşağıdaki alanlar belirtilebilir:

  • gradingPeriods
  • applyToExistingCoursework

Bu, tam nitelikli alan 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ü. Bu, Önizleme Programı'nda geliştiricilere sunulan yeni API özelliklerine erişmek için ayarlanmalıdır.

İstek içeriği

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

Yanıt gövdesi

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

Yetkilendirme kapsamları

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

  • https://www.googleapis.com/auth/classroom.courses

Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.