Method: courses.courseWork.rubrics.patch

• HTTP isteği
• Yol parametreleri
• Sorgu parametreleri
• İstek metni
• Yanıt metni
• Yetkilendirme kapsamları

Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Geliştirici Önizleme Programı kapsamında kullanılabilir. Bu özellik V1_20231110_PREVIEW ve sonraki sürümlerde kullanılabilir. Daha fazla bilgi edinmek için Önizleme API'lerine Erişim bölümüne bakın.

Bir puan anahtarını günceller.

Hangi alanların güncellenebileceğine ilişkin ayrıntılar için google.classroom.v1.Rubric adresine göz atın. Not verme başladıktan sonra puan anahtarı güncelleme özellikleri sınırlandırılır.

Bu istek, üst ders çalışması öğesini oluşturmak için kullanılan OAuth istemci kimliğine sahip Google Cloud Console üzerinden yapılmalıdır.

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

• PERMISSION_DENIED: İstekte bulunan geliştirici projesi ilgili sınıf çalışmasını oluşturmadıysa, kullanıcının puan anahtarında istenen değişikliği yapmasına izin verilmiyorsa veya erişim hataları nedeniyle. Puan anahtarında not verme işlemi başlamışsa bu hata kodu da döndürülür.
• İstek hatalıysa ve şu istek hatası ile ilişkiliyse INVALID_ARGUMENT:
  • RubricCriteriaInvalidFormat
• İstenen ders, sınıf çalışması veya puan anahtarı yoksa ya da kullanıcının ilgili sınıf çalışmasına erişimi yoksa NOT_FOUND.
• Puan anahtarında not verme işlemi başladıysa INTERNAL.

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. Kursun tanımlayıcısı.
courseWorkId	string Zorunlu. Sınıf çalışmasının tanımlayıcısı.
id	string İsteğe bağlı. Puan anahtarının tanımlayıcısı.

Sorgu parametreleri

Parametreler
updateMask	string (FieldMask format) İsteğe bağlı. Puan anahtarındaki hangi alanların güncelleneceğini tanımlayan maske. Bu alan güncelleme için gereklidir. Geçersiz alanlar belirtilirse güncelleme başarısız olur. Puan anahtarının ölçütlerini tanımlamak için birden fazla seçenek vardır: sourceSpreadsheetId ve criteria listesi. Puan anahtarını tanımlamak için aynı anda bunlardan yalnızca biri kullanılabilir. criteria puan anahtarı listesi, güncelleme isteğinde belirtilen puan anahtarı ölçütleriyle değiştirilir. Örneğin, istekte eksik olan bir ölçüt veya düzey varsa söz konusu öğe silinir. Yeni ölçütler ve seviyeler eklenip bir kimlik atanır. Mevcut ölçüt ve seviyeler, istekte belirtilen kimlik önceden atanmış kimliği korur. Aşağıdaki alanlar öğretmenler tarafından belirtilebilir: criteria sourceSpreadsheetId 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, 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
Önemli: sourceSpreadsheetId belirterek Google E-Tablosundan bir puan anahtarı oluşturmak için ek kapsamlar gerekir: https://www.googleapis.com/auth/spreadsheets.readonly veya https://www.googleapis.com/auth/spreadsheets. spreadsheets kapsamlarının hassas kabul edildiğini ve uygulamanızın doğrulanması gerekebileceğini unutmayın.

Daha fazla bilgi için Yetkilendirme kılavuzuna göz atın.