Method: courses.courseWork.patch

Bir ödevin bir veya daha fazla alanını günceller.

Hangi alanların güncellenebileceği ve bunları kimlerin değiştirebileceği hakkında ayrıntılı bilgi için google.classroom.v1.CourseWork başlıklı makaleyi inceleyin.

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 kurs ç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ı için.
  • İstek yanlış biçimlendirilmişse INVALID_ARGUMENT.
  • İstenen kurs çalışması zaten silinmişse FAILED_PRECONDITION
  • İstenen kurs veya kurs ç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 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)

Sınıf çalışmasındaki hangi alanların güncelleneceğini tanımlayan maske. Güncelleme yapmak için bu alanın doldurulması zorunludur. Geçersiz alanlar belirtilirse güncelleme başarısız olur. Bir alan boş değerleri destekliyorsa güncelleme maskesinde belirtilerek ve CourseWork nesnesinde belirtilmeyerek 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
  • learningGoals

Bu, alanların tam nitelikli adlarının virgülle ayrılmış 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ın yapılması gerekir.

İstek metni

İstek metni, CourseWork öğesinin bir örneğini içerir.

Yanıt metni

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ılavuzu'na bakın.