Method: courses.courseWork.patch

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

Hangi alanların güncellenebileceği ve bunları kimlerin değiştirebileceğiyle ilgili ayrıntılar için google.classroom.v1.CourseWork bölümüne bakın.

Bu istek, ilgili kurs çalışması öğesini oluşturmak için kullanılan OAuth istemci kimliğinin Developer Console projesi tarafından gönderilmelidir.

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

  • İstekte bulunan geliştirici projesi ilgili ders çalışmasını oluşturmadıysa, kullanıcının öğrenci gönderiminde istenen değişikliği yapmasına izin verilmiyorsa veya erişim hataları nedeniyle PERMISSION_DENIED.
  • INVALID_ARGUMENT ise istek yanlış biçimlendirilmiştir.
  • FAILED_PRECONDITION ise istenen kurs çalışması zaten silinmiş demektir.
  • İstenen ders veya ders ç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

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

string

Ders çalışmasının tanımlayıcısı.

Sorgu parametreleri

Parametreler
updateMask

string (FieldMask format)

Sınıf çalışmasında hangi alanların güncelleneceğini tanımlayan maske. Güncelleme yapmak için bu alanın doldurulması gerekir. Geçersiz alanlar belirtilirse güncelleme başarısız olur. Boş değerleri destekleyen bir alan, CourseWork nesnesinde değil güncelleme maskesinde belirtilerek temizlenebilir. Boş değerleri desteklemeyen bir alan güncelleme maskesine dahil edilirse ve CourseWork nesnesinde ayarlanmazsa INVALID_ARGUMENT hatası döndürülür.

Öğretmenler aşağıdaki alanları belirtebilir:

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

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