Method: courses.patch

Dersteki bir veya daha fazla alanı günceller.

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

  • İstekte bulunan kullanıcının, istenen kursu değiştirmesine izin verilmiyorsa veya erişim hataları varsa PERMISSION_DENIED.
  • İstenen kimliğe sahip ders yoksa NOT_FOUND.
  • Güncelleme maskesinde geçersiz alanlar belirtilmişse veya güncelleme maskesi sağlanmamışsa INVALID_ARGUMENT.
  • Aşağıdaki istek hataları için FAILED_PRECONDITION:
    • CourseNotModifiable
    • InactiveCourseOwner
    • IneligibleOwner

HTTP isteği

PATCH https://classroom.googleapis.com/v1/courses/{id}

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
id

string

Güncellenecek dersin tanımlayıcısı. Bu tanımlayıcı, Classroom tarafından atanan tanımlayıcı veya bir alias olabilir.

Sorgu parametreleri

Parametreler
updateMask

string (FieldMask format)

Kursta hangi alanların güncelleneceğini tanımlayan maske. Bu alan güncelleme için gereklidir. Geçersiz alanlar belirtilirse güncelleme başarısız olur. Aşağıdaki alanlar geçerlidir:

  • name
  • section
  • descriptionHeading
  • description
  • room
  • courseState
  • ownerId

Not: ownerId'ye yönelik yamalar hemen etkili olarak kabul edilir, ancak etkilenen tüm kaynakların sahiplik aktarımının tamamlanması pratikte biraz zaman alabilir.

Bir sorgu parametresinde ayarlandığında bu alan şu şekilde belirtilmelidir:

updateMask=<field1>,<field2>,...

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

İstek içeriği

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

Yanıt gövdesi

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

Yetkilendirme kapsamları

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

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

Daha fazla bilgi için Yetkilendirme kılavuzuna göz atın.