Method: courses.courseWork.patch

Bir sınıf çalışmasının bir veya daha fazla alanını günceller.

Hangi alanların güncellenebileceği ve bu alanları kimlerin değiştirebileceği hakkında ayrıntılı bilgi için google.classroom.v1.CourseWork sayfasına bakın.

Bu istek, ilgili kurs çalışması öğesini oluşturmak için kullanılan OAuth istemci kimliğinin Developer Console projesi tarafından 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 öğrenci gönderiminde istenen değişikliği yapmasına izin verilmiyorsa ya da erişim hataları nedeniyle.
  • İstek bozuksa INVALID_ARGUMENT.
  • İstenen sınıf çalışması zaten silinmişse FAILED_PRECONDITION.
  • İstenen ders veya sınıf çalışması mevcut değilse NOT_FOUND.

HTTP isteği

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

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

Yol parametreleri

Parametreler
courseId

string

Kursun tanımlayıcısı. Bu tanımlayıcı, Classroom tarafından atanan bir tanımlayıcı veya bir alias olabilir.
id

string

Sınıf çalışmasının tanımlayıcısı.

Sorgu parametreleri

Parametreler
updateMask

string (FieldMask format)

Kurstaki hangi alanların güncelleneceğini belirleyen maske. Bu alan, güncelleme yapmak için gereklidir. Geçersiz alanlar belirtilirse güncelleme başarısız olur. Bir alan, boş değerleri destekliyorsa CourseWork nesnesinde değil, güncelleme maskesinde belirtilerek temizlenebilir. Boş değerleri desteklemeyen bir alan, güncelleme maskesine dahil edilir ve CourseWork nesnesinde ayarlanmazsa INVALID_ARGUMENT hatası döndürülür.

Aşağıdaki alanlar öğretmenler tarafından belirtilebilir:

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId V1_20240401_PREVIEW ve sonraki sürümlerde kullanılabilir.

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, CourseWork öğesinin bir örneğini içerir.

Yanıt gövdesi

Başarılıysa yanıt metni, CourseWork öğ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ılavuzunu inceleyin.