Method: courses.patch

Bir kurstaki bir veya daha fazla alanı günceller.

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

  • PERMISSION_DENIED istemde bulunan kullanıcının istenen dersi değiştirmesine izin verilmiyorsa veya erişim hataları nedeniyle.
  • NOT_FOUND ise istenen kimliğe sahip bir kurs mevcut değildir.
  • Güncelleme maskesinde geçersiz alanlar belirtilmişse veya güncelleme maskesi sağlanmamışsa INVALID_ARGUMENT.
  • FAILED_PRECONDITION için aşağıdaki istek hataları:
    • 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ıdır. Bu tanımlayıcı, Classroom tarafından atanan tanımlayıcı veya bir alias olabilir.

Sorgu parametreleri

Parametreler
updateMask

string (FieldMask format)

Kurstaki 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. Aşağıdaki alanlar geçerlidir:

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

Not: ownerId için yapılan yamalar hemen geçerli olarak kabul edilir ancak etkilenen tüm kaynakların sahiplik aktarımının tamamlanması biraz zaman alabilir.

Bu alan, sorgu parametresinde ayarlandığında şu şekilde belirtilmelidir:

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

Bu, alanların tam nitelikli 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 bakın.