Method: courses.courseWorkMaterials.patch

Bir ders materyalinin bir veya daha fazla alanını günceller.

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

  • PERMISSION_DENIED, erişim hataları için istekte bulunan geliştirici projesi.
  • İstek yanlış biçimlendirilmişse INVALID_ARGUMENT.
  • FAILED_PRECONDITION İstenen ders materyali zaten silinmişse
  • İstenen kurs veya kurs materyali yoksa NOT_FOUND

HTTP isteği

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

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

Sorgu parametreleri

Parametreler
updateMask

string (FieldMask format)

Kurs materyalindeki 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 kurs materyali nesnesinde belirtilmeyerek temizlenebilir. Boş değerleri desteklemeyen bir alan güncelleme maskesine dahil edilirse ve kurs materyali nesnesinde ayarlanmazsa INVALID_ARGUMENT hatası döndürülür.

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

  • title
  • description
  • state
  • scheduledTime
  • topicId

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

enum (PreviewVersion)

İsteğe bağlı. Uç noktanın önizleme sürümü.

PREVIEW_VERSION_9001 yeni özellikler içerir: * Materyallerin güncellenmesi desteklenir. Materyalleri güncellemek için updateMask "materials"ı kullanın. İstekle birlikte gönderilen CourseWorkMaterial nesnesindeki malzeme listesi, mevcut listenin yerini tamamen alır. Malzemeler alanı, güncelleme maskesinde "materials" belirtilerek ve CourseWorkMaterial nesnesinde belirtilmeyerek temizlenebilir. YAYINLANDI CourseWorkMaterial durumundaki güncellemeler şu anda desteklenmemektedir.

İstek metni

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

Yanıt metni

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

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/classroom.courseworkmaterials

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