Google Classroom eklentileri artık geliştiricilerin genel kullanımına sunuldu! Daha fazla bilgi edinmek için lütfen
eklenti belgelerini inceleyin.
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.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-02-27 UTC.
[null,null,["Son güncelleme tarihi: 2025-02-27 UTC."],[[["Updates a course's grading period settings, requiring eligibility to modify them by both the requesting user and course owner."],["The request must include a field mask to specify which fields of the GradingPeriodSettings are to be updated, potentially adding, deleting, or editing grading periods."],["The API uses a PATCH request to `https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings`, where `{courseId}` is replaced with the specific course identifier."],["Potential errors include `PERMISSION_DENIED`, `INVALID_ARGUMENT`, and `NOT_FOUND` based on user permissions, request validity, and course existence."],["Authorization requires the `https://www.googleapis.com/auth/classroom.courses` OAuth scope."]]],[]]