Method: courses.courseWork.studentSubmissions.patch

Bir öğrenci gönderiminin 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.StudentSubmission başlıklı makaleyi inceleyin.

Bu istek, ilgili kurs ödevi öğesini oluşturmak için kullanılan OAuth istemci kimliğinin Developer Console projesi tarafından veya ilgili kurs ödevi öğesinde not senkronizasyonu etkinleştirilmiş bir eklenti eki tarafından yapılmalıdır.

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

  • İstekte bulunan geliştirici projesi, not senkronizasyonu etkinleştirilmiş ilgili kurs çalışmasını veya ilgili kurs çalışmasında bir eklenti eki oluşturmadıysa, kullanıcıya öğrenci gönderiminde istenen değişikliği yapma izni verilmediyse veya erişim hataları için PERMISSION_DENIED.
  • İstek yanlış biçimlendirilmişse INVALID_ARGUMENT.
  • İstenen kurs, sınıf çalışması veya öğrenci gönderimi yoksa NOT_FOUND

HTTP isteği

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{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.
courseWorkId

string

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

string

Öğrenci gönderiminin tanımlayıcısı.

Sorgu parametreleri

Parametreler
updateMask

string (FieldMask format)

Öğrenci gönderiminde 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.

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

  • draftGrade
  • assignedGrade

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

Yanıt metni

Başarılıysa yanıt metni, StudentSubmission öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/classroom.coursework.students
  • https://www.googleapis.com/auth/classroom.coursework.me

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.