Method: courses.courseWork.patch

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

Hangi alanların güncellenebileceği ve bunları kimlerin değiştirebileceği ile ilgili ayrıntılar için google.classroom.v1.CourseWork adresini ziyaret edin.

Bu istek, ilgili ders çalışması öğesini oluşturmak için kullanılan OAuth istemci kimliğine sahip Geliştirici Konsolu 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 istenen değişikliği öğrenci gönderiminde yapmasına izin verilmiyorsa veya erişim hataları varsa.
  • İstek hatalıysa INVALID_ARGUMENT.
  • İstenen sınıf çalışması silinmişse FAILED_PRECONDITION.
  • İstenen ders, sınıf çalışması veya öğrenci gönderimi yoksa 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 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)

Dersteki hangi alanların güncellenmesi gerektiğini tanımlayan maske. Bu alan güncelleme için gereklidir. Geçersiz alanlar belirtilirse güncelleme başarısız olur. Bir alan boş değerleri destekliyorsa alan CourseWork nesnesinde değil, güncelleme maskesinde belirtilerek temizlenebilir. Güncelleme maskesine boş değerleri desteklemeyen bir alan eklenirse 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

Bu, tam nitelikli alan adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".

İ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ılavuzuna göz atın.