Method: courses.updateGradingPeriodSettings

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

Bu yöntemle, notlandırma dönemleri tek tek eklenebilir, kaldırılabilir veya değiştirilebilir.

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

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

  • PERMISSION_DENIED istek gönderen kullanıcının bir kurstaki notlandırma dönemi ayarlarını değiştirmesine izin verilmiyorsa veya erişim hataları için:
    • UserIneligibleToUpdateGradingPeriodSettings
  • INVALID_ARGUMENT ise istek yanlış biçimlendirilmiştir.
  • NOT_FOUND ise istenen kurs mevcut değildir.

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. Dersin tanımlayıcısıdır.

Sorgu parametreleri

Parametreler
updateMask

string (FieldMask format)

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

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

  • Kimlik olmadan listeye eklenen notlandırma dönemleri ek olarak kabul edilir ve istek gönderildiğinde yeni bir kimlik atanır.
  • Şu anda mevcut olan ancak istekte bulunmayan notlandırma dönemleri silinmiş olarak kabul edilir.
  • Mevcut kimliği ve değiştirilmiş verileri olan notlandırma dönemleri düzenleme olarak kabul edilir. Değiştirilmemiş veriler olduğu gibi bırakılır.
  • Bilinmeyen bir kimlikle birlikte eklenen notlandırma dönemleri hataya neden olur.

Aşağıdaki alanlar belirtilebilir:

  • gradingPeriods
  • applyToExistingCoursework

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, 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ılavuzuna bakın.